ControlGetItems

Gibt ein Array aller Einträge/Zeilen in einer ListBox, ComboBox oder DropDownList zurück.

Einträge := ControlGetItems(Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)

Parameter

Steuerelement

Typ: Zeichenkette, Integer oder Objekt

ClassNN-Bezeichnung, Text oder HWND-Nummer des Steuerelements, oder ein Objekt mit einer Hwnd-Eigenschaft. Einzelheiten finden Sie unter Der Steuerelement-Parameter.

FensterTitel, FensterText, AusnahmeTitel, AusnahmeText

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 (Textelemente können mit dem internen Tool "Window Spy" in Erfahrung gebracht werden).

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 und DetectHiddenText geändert werden kann. 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.

Rückgabewert

Typ: Array

Diese Funktion gibt ein Array zurück, das den Text jedes Listeneintrags bzw. jeder Zeile enthält.

Fehlerbehandlung

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 z.B. eine Meldung einen Fehlercode zurückgibt oder nicht gesendet werden konnte.

Bemerkungen

Einige Anwendungen behandeln die Daten ihrer Listeneinträge vertraulich, so dass ihr Text nicht abgerufen werden kann. In solchen Fällen wird normalerweise keine Ausnahme ausgelöst, aber alle abgerufenen Felder sind leer.

ListViewGetContent, WinGetList, Control-Funktionen

Beispiele

Geht die Listeneinträge einzeln durch.

for Eintrag in ControlGetItems("ComboBox1", FensterTitel)
    MsgBox "Eintragsnummer " A_Index " ist " Eintrag

Greift via Indexnummer auf einen bestimmten Listeneintrag zu.