Sucht per Zeichenkette einen Eintrag in einem Listenfeld, Kombinationsfeld oder einer Dropdownliste und gibt seine Positionsnummer zurück.
PosN := ControlFindItem(Zkette, StrlmntID , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)
Typ: Zeichenkette
Der vollständige Text eines Listeneintrags, der gefunden werden soll.
Die Suche erfolgt nicht Groß-/Kleinschreibung-sensitiv. Wenn z.B. ein Listenfeld den Eintrag "UNIX" enthält, würde das Wort unix (kleingeschrieben) diesen Eintrag finden.
Typ: Zeichenkette, Integer oder Objekt
ClassNN, Text oder HWND des Steuerelements, oder ein Objekt mit einer Hwnd-Eigenschaft. Einzelheiten finden Sie unter Steuerelementidentifikatoren.
Typ: Zeichenkette, Integer oder Objekt
Wenn jeder dieser Parameter leer ist oder weggelassen wird, wird das Zuletzt Gefundene Fenster verwendet. Andernfalls geben Sie für FensterTitel einen Fenstertitel oder andere Kriterien zur Identifizierung des Zielfensters und/oder für FensterText eine Teilzeichenkette aus einem Textelement des Zielfensters an (wie von Window Spy angezeigt).
AusnahmeTitel und AusnahmeText können verwendet werden, um ein oder mehrere Fenster anhand ihres Titels oder Textes auszuschließen. Ihre Angabe ähnelt der von FensterTitel und FensterText, außer dass AusnahmeTitel keine anderen Kriterien als den Fenstertitel erkennt.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Standardmäßig werden versteckte Fenster nicht erkannt und versteckte Textelemente erkannt, was mit DetectHiddenWindows bzw. DetectHiddenText geändert werden kann. Verwendet man reine HWNDs, werden versteckte Fenster immer erkannt. Standardmäßig kann ein Fenstertitel den angegebenen FensterTitel oder AusnahmeTitel an beliebiger Stelle enthalten, um eine Übereinstimmung zu sein, was mit SetTitleMatchMode geändert werden kann.
Typ: Integer
Diese Funktion gibt die Positionsnummer des ersten Listeneintrags zurück, der exakt mit Zkette übereinstimmt. Der erste Eintrag ist 1, der zweite 2 und so weiter. Wenn nichts gefunden wurde, wird eine Ausnahme ausgelöst.
Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte oder wenn der Klassenname des Steuerelements weder "Combo" noch "List" enthält.
Es wird ein Error ausgelöst, wenn der Listeneintrag nicht gefunden werden konnte.
Im Gegensatz zu ControlChooseString muss der vollständige Text des Eintrags übereinstimmen, nicht nur der beginnende Teil.
Um die Zuverlässigkeit zu erhöhen, erfolgt jedes Mal, nachdem diese Funktion verwendet wurde, automatisch eine Verzögerung. Diese Verzögerung kann mit SetControlDelay oder durch Zuweisung eines Wertes an A_ControlDelay geändert werden. Weitere Informationen finden Sie unter SetControlDelay-Bemerkungen.