wcFindItem (Funktion)

Ermittelt den Index des ersten Eintrags im Listen- oder Kombinationsfeld, der mit dem angegebenen Suchtext übereinstimmt.

Kategorie

Windows-Steuerelemente

Syntax

[Ergebniscode=]wcFindItem ("Steuerelement", "Meldungsvariable", GroßKlein, Variable);

Parameter

Steuerelement

Der Name des Windows-Steuerelements, Bsp.: ListenFeld_1. Zeichenfolge oder Meldungsvariable.

Meldungsvariable

Zeichenfolge, die verglichen werden soll. Zeichenfolge oder Meldungsvariable.

GroßKlein

Bestimmt den Typ des Vergleichs. Binärwert oder -variable. Folgende Werte sind zulässig:

0 = Groß- und Kleinschreibung wird nicht berücksichtigt.

1 = Groß- und Kleinschreibung wird berücksichtigt.

Variablenname

Integer-Variable, in die der Index des gefundenen Eintrags zurückgegeben wird. Wenn kein passender Eintrag gefunden werden kann, wird -1 zurückgegeben.

Anmerkungen

Eine Liste der Ergebniscodes finden Sie unter Fehlermeldungen von Windows-Steuerelementen auswerten

Geltungsbereich

Listenfelder und Kombinationsfelder.

Beispiel(e)

Angenommen, das Listenfeld ListenFeld_1 enthält die Einträge "EintragA", "EintragB" und "EintragC", so liefert die Funktion folgende Werte an die Variable "Ergebnis" zurück:

wcFindItem("ListenFeld_1", "EintragB", 0, Ergebnis);

gibt 2 zurück

wcFindItem("ListenFeld_1", "Eintragb", 1, Ergebnis);

gibt -1 zurück

wcFindItem("ListenFeld_1", "eintragc", 0, Ergebnis);

gibt 3 zurück

wcFindItem("ListenFeld_1", "XYZ", 0, Ergebnis);

gibt -1 zurück