VP SET VALUES

Home

4D v19

VP SET VALUES


VP SET VALUES ( rangeObj ; valuesCol )

Parameter	Typ	Beschreibung
rangeObj	Objekt	Objekt Zellen-Range
valuesCol	Collection	Collection von Werten

Beschreibung

Der Befehl VP SET VALUES weist dem angegebenen Zellen-Range eine Collection von Werten zu.

In rangeObj übergeben Sie einen Range der Zelle (erstellt mit VP Cell), dessen Wert Sie angeben wollen. Die im rangeObj definierte Zelle dient zum Bestimmen des Startpunktes.

Hinweise:

Ist rangeObj kein Zellen-Range, wird nur die erste Zelle des Range verwendet.
Enthält rangeObj mehrere Ranges, wird nur die erste Zelle des ersten Range verwendet.

Der Parameter valuesCol ist zweidimensional:

Die Collection auf erster Ebene enthält Unter-Collections von Werten. Jede Unter-Collection definiert eine Zeile. Zum Überspringen einer Zeile übergeben Sie eine leere Collection.
Jede Unter-Collection definiert Zellenwerte für die Zeile. Werte können vom Typ Lange Ganzzahl, Zahl, Boolean, Text, Datum, Null oder Objekt sein. Ein Wert vom Typ Objekt kann folgende Eigenschaften haben:

Eigenschaft Typ Beschreibung
Wert Lange Ganzzahl, Zahl, Boolean, Text, Datum, Null Wert in der Zelle (außer Zeit)
Zeit Zahl Zeitwert (in Sekunden)

Beispiel

Folgender Code:

 $param:=New collection

 $param.push(New collection(1;2;3;False)) //erste Zeile, 4 Werte

 $param.push(New collection) //zweite Zeile, nicht berührt

 $param.push(New collection(4;5;Null;"hello";"world")) // dritte Zeile, 5 Werte

 $param.push(New collection(6;7;8;9)) // vierte Zeile, 4 Werte

 $param.push(New collection(Null;New object("value";Current date;"time";42))) //fünfte Zeile, 1 Wert

 VP SET VALUES(VP Cell("ViewProArea";2;1);$param)

... liefert folgendes Ergebnis:

Siehe auch

VP Get formulas
VP Get value
VP Get values
VP SET FORMULAS
VP SET VALUE