VP Find

Home

4D v19

VP Find


VP Find ( rangeObj ; searchValue {; searchCondition {; replaceValue}} ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
rangeObj	Objekt	Range Objekt
searchValue	Text	Suchwert
searchCondition	Objekt	Objekt mit den Suchkriterien
replaceValue	Text	Wert für Ersetzen
Funktionsergebnis	Objekt	Range Objekt

Beschreibung

Der Befehl VP Find sucht in rangeObj nach searchValue. Über optionale Parameter können Sie die Suche weiter spezifizieren und die gefundenen Ergebnisse ersetzen.

Im Parameter rangeObj übergeben Sie ein Objekt mit dem Range für die Suche.

Im Parameter searchValue übergeben Sie den Suchtext für rangeObj.

Im optionalen Parameter searchCondition können Sie weitere Angaben für die Suche machen. Es gibt folgende Eigenschaften:

Eigenschaft Typ Beschreibung

afterColumn Lange Ganzzahl Spaltennummer vor der Spalte, wo die Suche startet. Ist rangeObj ein kombinieres Range, muss die angegebene Nummer vom ersten Range stammen. Standardwert: -1 (Beginn von rangeObj)

afterRow Lange Ganzzahl Zeilennummer vor der Zeile, wo die Suche startet. Ist rangeObj iein kombinieres Range, muss die angegebene Nummer vom ersten Range stammen. Standardwert: -1 (Beginn von rangeObj)

all

Boolean

Wahr - Alle Zellen in rangeObj, die searchValue entsprechen, werden zurückgegeben.
Falsch - (Standardwert) Nur die erste Zelle in rangeObj, die searchValue entspricht, wird zurückgegeben.

flags

Lange Ganzzahl

Konstante	Kommentar
vk find flag exact match	Legt fest, dass der ganze Inhalt der Zelle exakt zum Suchwert passen muss.
vk find flag ignore case	Legt fest, dass Groß- und Kleinschreibung gleich gewertet werden. Beispiel: "a" ist dasselbe wie "A".
vk find flag none	Legt fest, dass keine Such Flags berücksichtigt werden. (Standard)
vk find flag use wild cards	Legt fest, dass Platzhalterzeichen (,?) im Suchstring verwendbar sind. Platzhalter lassen sich bei Stringvergleichen bzw. für eine beliebige Anzahl an Zeichen verwenden. - Für null oder mehrere Zeichen. Beispiel: die Suche nach "bl*" findet "bl", "bleiben", "blau" und "blob". ? - Für ein einzelnes Zeichen. Beispiel: die Suche nach "h?t" findet "hut", "hat" und "hit".

Diese Flags sind kombinierbar. Zum Beispiel:

$search.flags:=vk find flag use wild cards+vk find flag ignore case

order

Lange Ganzzahl

Konstante	Kommentar
vk find order by columns	Legt fest, dass die Suche spaltenweise läuft, d.h. die Suche geht durch jede Zeile einer Spalte und dann zur nächsten Spalte.
vk find order by rows	Legt fest, dass die Suche zeilenweise läuft, d.h. die Suche geht durch jede Spalte einer Zeile und dann zur nächsten Zeile (Standard).

target

Lange Ganzzahl

Konstante	Kommentar
vk find target formula	Legt fest, dass die Suche in der Zellenformel ausgeführt wird.
vk find target tag	Legt fest, dass die Suche im Zellentag ausgeführt wird.
vk find target text	Legt fest, dass die Suche im Zellentext ausgeführt wird. (Standard)

Diese Flags sind kombinierbar. Zum Beispiel:

$search.target:=vk find target formula+vk find target text

Im optionalen Parameter replaceValue können Sie Text übergeben, um jedes gefundene Vorkommen von searchValue innerhalb von rangeObj zu ersetzen.

Zurückgegebenes Objekt

Die Funktion gibt ein Range Objekt mit allen gefundenen bzw. ersetzten Suchwerten zurück. Werden keine Ergebnisse gefunden, wird ein leeres Range Objekt zurückgegeben.

Beispiel 1

Die erste Zelle mit dem Wort "Total" finden:

 var $range;$result : Object

 

 $range:=VP All("ViewProArea")

 

 $result:=VP Find($range;"Total")

Beispiel 2

Das Wort "Total" finden und mit "Grand Total" ersetzen:

 var $range;$condition;$result : Object

 

 $range:=VP All("ViewProArea")

 

 $condition:=New object

 $condition.target:=vk find target text

 $condition.all:=True //Search entire document

 $condition.flags:=vk find flag exact match

 

  // Replace the cells containing only 'Total' in the current sheet with "Grand Total"

 $result:=VP Find($range;"Total";$condition;"Grand Total")

 

  // Check for empty range object 

 If($result.ranges.length=0)

    ALERT("No result found")

 Else

    ALERT($result.ranges.length+" results found")

 End if