ControlGetClassNN

Gibt die ClassNN-Bezeichnung (Klassenname und Sequenznummer) eines bestimmten Steuerelements zurück.

ClassNN := ControlGetClassNN(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: Zeichenkette

Diese Funktion gibt die ClassNN-Bezeichnung (Klassenname und Sequenznummer) des angegebenen Steuerelements zurück.

Fehlerbehandlung

Es wird ein TargetError ausgelöst, wenn das Zielfenster oder Zielsteuerelement nicht ermittelt werden konnte.

Es wird ein Error oder OSError ausgelöst, wenn die ClassNN-Bezeichnung nicht ermittelt werden konnte.

Bemerkungen

Die ClassNN-Bezeichnung eines Steuerelements besteht aus dem Namen seiner Fensterklasse gefolgt von seiner Sequenznummer innerhalb des Top-Level-Fensters, das dieses Steuerelement enthält. Zum Beispiel ist "Edit1" das erste Edit-Steuerelement in einem Fenster und "Button12" die zwölfte Schaltfläche.

Die ClassNN-Bezeichnung eines Steuerelements kann auch mit Window Spy, MouseGetPos oder WinGetControls ermittelt werden.

Einige Klassennamen enthalten Ziffern, die nicht zur Sequenznummer des Steuerelements gehören. Zum Beispiel ist "SysListView321" das erste ListView-Steuerelement in einem Fenster, nicht das dreihunderteinundzwanzigste. Um den Klassennamen ohne Sequenznummer abzurufen, übergeben Sie die HWND-Nummer des Steuerelements an WinGetClass.

WinGetClass, WinGetControls, ClassNN-Eigenschaft (GuiControl-Objekt), MouseGetPos, Control-Funktionen

Beispiele

Ruft die ClassNN-Bezeichnung des aktuell fokussierten Steuerelements ab.

classNN := ControlGetClassNN(ControlGetFocus("A"))