- Ungesetzte Parameter @@ -67,7 +68,13 @@
- Wenn ein Parameter in einem Funktionsaufruf eine Variable enthält (z.B.
Varoder++VaroderVar*=2), können andere Parameter links oder rechts davon diese Variable ändern, bevor sie an die Funktion übergeben wird. Zum Beispiel würdeMeineFunk(Var, Var++)unerwartet 1 und 0 als Parameter übergeben, wenn Var zu Beginn 0 ist, da das erste Var erst bei Ausführung des Funktionsaufrufs dereferenziert wird. Dieses Verhalten ist nicht intuitiv und könnte sich in einer zukünftigen Version ändern.
+
Einführung und einfache Beispiele
Parameter
Beim Definieren einer Funktion werden ihre Parameter in runden Klammern rechts neben ihrem Namen aufgelistet (zwischen dem Namen und der runden Startklammer sind keine Leerzeichen erlaubt). Wenn die Funktion keine Parameter akzeptiert, kann der Inhalt zwischen den runden Klammern leer gelassen werden, z.B. ErmittleAktuellenZeitstempel().
ByRef-Parameter: Innerhalb der Funktion werden Parameter grundsätzlich als lokale Variablen behandelt, es sei denn, sie werden wie im folgenden Beispiel als ByRef markiert:
+Bekannte Einschränkung:
+-
+
ByRef-Parameter
+Innerhalb der Funktion werden Parameter grundsätzlich als lokale Variablen behandelt, es sei denn, sie werden wie im folgenden Beispiel als ByRef markiert:
a := 1, b := 2 Tauschen(&a, &b) MsgBox a ',' b @@ -91,8 +98,9 @@Parameter
Bekannte Einschränkungen:
- Es ist nicht möglich, eine VarRef für eine Objekteigenschaft (z.B.
foo.bar), A_Clipboard oder eine andere interne Variable zu konstruieren, sodass diese nicht via ByRef übergeben werden können.
- - Wenn ein Parameter in einem Funktionsaufruf eine Variable enthält (z.B.
Varoder++VaroderVar*=2), können andere Parameter links oder rechts davon diese Variable ändern, bevor sie an die Funktion übergeben wird. Zum Beispiel würdeMeineFunk(Var, Var++)unerwartet 1 und 0 als Parameter übergeben, wenn Var zu Beginn 0 ist, da das erste Var erst bei Ausführung des Funktionsaufrufs dereferenziert wird. Dieses Verhalten ist nicht intuitiv und könnte sich in einer zukünftigen Version ändern.
+ - Wenn der Parameter optional ist, kann nicht festgestellt werden, ob die vom Parameter referenzierte Variable eine neu erstellte lokale Variable oder eine vom Aufrufer übergebene Variable ist. Eine Alternative besteht darin, einen Nicht-ByRef-Parameter zu verwenden, ihm aber eine VarRef zu übergeben und ihn von der Funktion explizit dereferenzieren zu lassen oder ihn an den ByRef-Parameter einer anderen Funktion zu übergeben (ohne den
&-Operator zu verwenden).
Optionale Parameter
Beim Definieren einer Funktion können beliebig viele Parameter als optional gekennzeichnet werden.
Fügen Sie := an, gefolgt von einer direkt geschriebenen Zahl, einer in Anführungszeichen gesetzten Zeichenkette wie "fox" oder "", oder einem Ausdruck, der jedes Mal ausgewertet werden soll, wenn der Parameter mit seinem Standardwert initialisiert werden muss. Zum Beispiel würde X:=[] jedes Mal ein neues Array erzeugen.
Multimediatasten
Ausdrucksoperatoren (absteigende Priorität)
IN
CONTAINS
Wert is Klasse ist True (1), wenn Wert eine Instanz von Klasse ist, andernfalls False (0). Klasse muss eine Instanz der Object-Klasse mit einer eigenen Prototype-Eigenschaft sein, aber in der Regel wird die Eigenschaft implizit via Klassendefinition definiert. Diese Operation ist grundsätzlich äquivalent zu HasBase(Wert, Klasse.Prototype).
in und contains sind für die zukünftige Verwendung reserviert.
in und contains sind für zukünftige Zwecke reserviert.
-Version 2.0.9
+Version 2.0.10
Eine deutsche Übersetzung von https://www.autohotkey.com/docs/v2/ (siehe hier für mehr Details).
© 2014 Steve Gray, Chris Mallett, zum Teil © AutoIt-Team und andere
Software-Lizenz: GNU General Public License
diff --git a/target/docs/lib/Class.htm b/target/docs/lib/Class.htm index 43ce43b6..a5dc2470 100644 --- a/target/docs/lib/Class.htm +++ b/target/docs/lib/Class.htm @@ -16,9 +16,9 @@Class-Objekt
class Class extends Object
Ein Class-Objekt repräsentiert eine Klassendefinition; es enthält statische Methoden und Eigenschaften.
-Jedes Klassenobjekt basiert auf dem, was auch immer es erweitert, oder auf Object, wenn es nicht angegeben ist. Das globale Klassenobjekt Object basiert auf Class.Prototype, das wiederum auf Object.Prototype basiert, so dass Klassen beliebige Methoden und Eigenschaften von jedem dieser Basisobjekte erben können.
"Statische" Methoden und Eigenschaften sind alle Methoden und Eigenschaften, die dem Class-Objekt selbst gehören (und daher nicht für eine bestimmte Instanz gelten), während Methoden und Eigenschaften für Instanzen der Klasse dem Prototyp der Klasse gehören.
-"ClassObj" wird hier stellvertretend für ein beliebiges Class-Objekt verwendet, da "Class" die Klasse selbst ist. Normalerweise verweist man auf ein Class-Objekt via Name, der in dessen Klassendefinition angegeben ist.
+Jedes Klassenobjekt basiert auf der Klasse, die es erweitert, oder auf Object, falls nicht angegeben. Das globale Klassenobjekt Object basiert auf Class.Prototype, das wiederum auf Object.Prototype basiert, so dass Klassen Methoden und Eigenschaften von jedem dieser Basisobjekte erben können.
"Statische" Methoden und Eigenschaften sind alle Methoden und Eigenschaften, die dem Klassenobjekt selbst gehören (und daher nicht für eine bestimmte Instanz gelten), während Methoden und Eigenschaften für Instanzen der Klasse dem Prototyp der Klasse gehören.
+"ClassObj" wird hier stellvertretend für ein beliebiges Klassenobjekt verwendet, da "Class" die Klasse selbst ist. Normalerweise wird auf ein Klassenobjekt via Name verwiesen, der in dessen Klassendefinition angegeben ist.
Inhaltsverzeichnis
-
@@ -40,16 +40,16 @@
Methoden
Konstruiert eine neue Instanz der Klasse.
Obj := ClassObj(Params*)
Obj := ClassObj.Call(Params*)
-Diese statische Methode wird typischerweise von der Object-, Array- oder Map-Klasse geerbt. Es führt die folgenden Funktionen aus:
+Diese statische Methode wird typischerweise von der Object-, Array- oder Map-Klasse geerbt. Sie führt die folgenden Funktionen aus:
-
-
- Speicher zuweisen und die binäre Struktur des Objekts initialisieren, was vom nativen Typ des Objekts abhängt (z.B. ob es ein Array oder Map-Objekt ist, oder nur ein Objekt). +
- Speicher reservieren und die binäre Struktur des Objekts initialisieren, was vom nativen Typ des Objekts abhängt (z.B. ob es ein Array oder Map ist, oder ob es nur ein Object ist).
- Die Basis des neuen Objekts auf ClassObj.Prototype setzen.
- Die __Init-Methode des neuen Objekts aufrufen, falls sie eine hat. Diese Methode wird automatisch via Klassendefinitionen erzeugt; sie enthält alle im Klassenkörper definierten Instanzvariableninitialisierer. -
- Die __Init-Methode des neuen Objekts aufrufen, falls sie eine hat. Alle Parameter, die an Call übergeben werden, werden an __New weitergeleitet. +
- Die __New-Methode des neuen Objekts aufrufen, falls sie eine hat. Alle an Call übergebenen Parameter werden an __New weitergeleitet.
- Das neue Objekt zurückgeben.
Call kann innerhalb einer Klassendefinition überschrieben werden, indem eine statische Methode definiert wird, wie z.B. static Call(). Dadurch können Klassen die Konstruktion neuer Instanzen ändern oder verhindern.
Beachten Sie, dass Class() (in diesem Fall tatsächlich "Class") verwendet werden kann, um ein neues Class-Objekt basierend auf Class.Prototype zu erstellen. Dieses neue Objekt hat jedoch zunächst keine Call-Methode, da es keine Unterklasse von Object ist. Um es zu einer Unterklasse von Object zu machen, weisen Sie es dessen Base zu, oder reimplementieren Sie die Call-Methode oder kopieren Sie sie von einer anderen Klasse. Ein Prototyp muss ebenfalls erstellt und der Klasse zugewiesen werden, bevor es mit der Standard-Call-Methode instanziiert werden kann.
Call kann innerhalb einer Klassendefinition durch Definieren einer statischen Methode überschrieben werden, z.B. static Call(). Auf diese Weise können Klassen die Konstruktion neuer Instanzen ändern oder verhindern.
Beachten Sie, dass Class() (in diesem Fall tatsächlich "Class") verwendet werden kann, um ein neues Class-Objekt basierend auf Class.Prototype zu konstruieren. Dieses neue Objekt hat jedoch zunächst keine Call-Methode, da es keine Unterklasse von Object ist. Es kann zu einer Unterklasse von Object durch Zuweisung an Base gemacht werden, oder die Call-Methode kann reimplementiert oder aus einer anderen Klasse kopiert werden. Außerdem muss ein Prototyp erstellt und der Klasse zugewiesen werden, bevor sie mit der Standard-Call-Methode instanziiert werden kann.
Eigenschaften
@@ -58,9 +58,9 @@Eigenschaften
Ermittelt oder setzt das Objekt, auf dem alle Instanzen der Klasse basieren.
Proto := ClassObj.Prototype
ClassObj.Prototype := Proto
-Der Prototyp der Klasse enthält standardmäßig alle Instanzmethoden und dynamischen Eigenschaften, die in der Klassendefinition definiert sind, und kann verwendet werden, um Referenzen zu Methoden oder Eigenschaft-Getters/Setters abzurufen oder neue zu definieren. Das Skript kann zudem neue Werteigenschaften definieren, die als Standardeigenschaftswerte für alle Instanzen fungieren.
-Der Protoyp einer Klasse basiert normalerweise auf dem Prototyp ihrer Basisklasse, also gilt ClassObj.Prototype.base == ClassObj.base.Prototype.
Prototype wird automatisch als eine eigene Eigenschaft eines Class-Objekts, das via Klassendefinition erzeugt wurde, definiert.
+Der Prototyp der Klasse enthält standardmäßig alle Instanzmethoden und dynamischen Eigenschaften, die in der Klassendefinition definiert sind, und kann verwendet werden, um Referenzen zu Methoden oder Getters/Setters von Eigenschaften abzurufen oder neue zu definieren. Das Skript kann zudem neue Werteigenschaften definieren, die als Standardeigenschaftswerte für alle Instanzen dienen.
+Der Prototyp einer Klasse basiert normalerweise auf dem Prototyp ihrer Basisklasse, folglich ist ClassObj.Prototype.base == ClassObj.base.Prototype.
Prototype wird automatisch als eigene Eigenschaft eines Klassenobjekts, das via Klassendefinition erzeugt wurde, definiert.
diff --git a/target/docs/lib/Click.htm b/target/docs/lib/Click.htm index 0e9f5147..09f5c25a 100644 --- a/target/docs/lib/Click.htm +++ b/target/docs/lib/Click.htm @@ -21,24 +21,24 @@Parameter
Geben Sie eine oder mehrere der folgenden Komponenten an: Koordinaten, WelcheTaste, KlicksAnzahl, DownOderUp und/oder Relativ. Wenn alle Komponenten weggelassen werden, wird ein einfacher Linksklick auf der aktuellen Position des Mauszeigers ausgeführt.
-Die Komponenten können auf mehrere Parameter verteilt oder in einer oder mehreren Zeichenketten zusammengefasst sein. Jeder Parameter kann entweder eine einzelne numerische Komponente oder eine Zeichenkette mit beliebig vielen Komponenten sein, wobei alle Komponenten durch mindestens ein Leerzeichen, Tabulatorzeichen und/oder Komma (alle innerhalb der Zeichenkette) voneinander getrennt sind. Zum Beispiel ist Click 100, 200, "R D" äquivalent zu Click "100 200 R D" und beide sind gültig. Leere oder weggelassene Parameter werden ignoriert, ebenso wie zusätzliche Kommas.
Die Komponenten können auf mehrere Parameter verteilt oder in eine oder mehrere Zeichenketten zusammengefasst werden. Jeder Parameter kann entweder eine einzelne numerische Komponente oder eine Zeichenkette mit beliebig vielen Komponenten sein, wobei alle Komponenten durch mindestens ein Leerzeichen, Tabulatorzeichen und/oder Komma (alle innerhalb der Zeichenkette) voneinander getrennt sein müssen. Zum Beispiel sind Click 100, 200, "R D" und Click "100 200 R D" funktionsgleich und gültig. Leere oder weggelassene Parameter werden ignoriert, ebenso wie zusätzliche Kommas.
Warnung: Click 100 200 ist äquivalent zu Click "100200", da die beiden Zahlen vor dem Funktionsaufruf verkettet werden.
Die Komponenten können in beliebiger Reihenfolge angegeben werden, außer KlicksAnzahl, das rechts von Koordinaten stehen muss, falls vorhanden.
Koordinaten: Wenn weggelassen, wird die aktuelle Position des Mauszeigers verwendet. Andernfalls geben Sie die X- und Y-Koordinate der Position an, auf die der Mauszeiger vor dem Klicken bewegt werden soll. Zum Beispiel klickt Click "100 200" mit der linken Maustaste auf eine bestimmte Position. Standardmäßig sind Koordinaten relativ zum Clientbereich des aktiven Fensters, was aber mit CoordMode geändert werden kann.
WelcheTaste: Wenn weggelassen, wird standardmäßig Left verwendet (die linke Maustaste). Andernfalls geben Sie Left, Right, Middle (oder jeweils nur den ersten Buchstaben) oder X1 (vierte Maustaste) oder X2 (fünfte Maustaste) an. Zum Beispiel klickt Click "Right" mit der rechten Maustaste auf die aktuelle Position des Mauszeigers. Left ist die primäre Maustaste und Right die sekundäre Maustaste. Wenn der Benutzer die Maustasten via Systemsteuerung vertauscht, werden die physischen Positionen der Maustasten vertauscht, aber der Effekt bleibt der gleiche.
WelcheTaste kann auch WheelUp oder WU sein, um das Mausrad nach oben zu drehen (von Ihnen weg), oder WheelDown oder WD, um es nach unten zu drehen (zu Ihnen hin). WheelLeft (WL) oder WheelRight (WR) kann ebenfalls angegeben werden. KlicksAnzahl ist die Anzahl der Schritte, um die das Mausrad gedreht werden soll. Einige Anwendungen ignorieren jedoch einen KlicksAnzahl-Wert höher als 1 in Bezug auf das Mausrad. Verwenden Sie für solche Anwendungen mehrmals die Click-Funktion, z.B. mithilfe einer Schleife.
-KlicksAnzahl: Wenn weggelassen, wird standardmäßig 1 verwendet. Andernfalls geben Sie an, wie oft die Maustaste geklickt oder das Mausrad gedreht werden soll. Zum Beispiel macht Click 2 einen Doppelklick auf der aktuellen Position des Mauszeigers. Wenn Koordinaten angegeben sind, muss KlicksAnzahl nach diesen angegeben werden. Geben Sie eine 0 an, um den Mauszeiger ohne Klicken zu verschieben; zum Beispiel Click "100 200 0".
WelcheTaste: Wenn weggelassen, wird standardmäßig Left verwendet (die linke Maustaste). Andernfalls geben Sie Left, Right, Middle (oder jeweils nur den ersten Buchstaben) oder X1 (vierte Maustaste) oder X2 (fünfte Maustaste) an. Zum Beispiel klickt Click "Right" mit der rechten Maustaste auf die aktuelle Position des Mauszeigers. Left ist die primäre Maustaste und Right die sekundäre Maustaste. Wenn der Benutzer die Maustasten über die Systemsteuerung vertauscht, werden die physischen Positionen der Maustasten vertauscht, aber der Effekt bleibt derselbe.
WelcheTaste kann auch WheelUp oder WU sein, um das Mausrad nach oben zu drehen (von Ihnen weg), oder WheelDown oder WD, um es nach unten zu drehen (zu Ihnen hin). WheelLeft (WL) oder WheelRight (WR) kann ebenfalls angegeben werden. KlicksAnzahl ist die Anzahl der Schritte, um die das Mausrad gedreht werden soll. Einige Anwendungen ignorieren jedoch eine KlicksAnzahl höher als 1 beim Drehen des Mausrads. Für solche Anwendungen können Sie die Click-Funktion mehrfach verwenden, z.B. mit Loop.
+KlicksAnzahl: Wenn weggelassen, wird standardmäßig 1 verwendet. Andernfalls geben Sie an, wie oft die Maustaste geklickt oder das Mausrad gedreht werden soll. Zum Beispiel macht Click 2 einen Doppelklick auf der aktuellen Position des Mauszeigers. Wenn Koordinaten angegeben sind, muss KlicksAnzahl nach diesen angegeben werden. Geben Sie 0 an, um den Mauszeiger ohne Klicken zu bewegen, z.B. Click "100 200 0".
DownOderUp: Wenn weggelassen, besteht jeder Klick aus einem Down- und Up-Ereignis. Andernfalls geben Sie das Wort Down (oder den Buchstaben D) an, um die Maustaste dauerhaft nach unten zu drücken. Später kann das Wort Up (oder der Buchstabe U) verwendet werden, um die Maustaste loszulassen. Zum Beispiel drückt Click "Down" die linke Maustaste nach unten und hält sie gedrückt.
Relativ: Wenn weggelassen, werden die X- und Y-Koordinate für die absolute Positionierung verwendet. Andernfalls geben Sie das Wort Rel oder Relative an, um die X- und Y-Koordinate als Offsets von der aktuellen Mausposition zu behandeln. Mit anderen Worten, der Mauszeiger wird von seiner aktuellen Position aus um X Pixel nach rechts (nach links, wenn negativ) und um Y Pixel nach unten (nach oben, wenn negativ) bewegt.
Bemerkungen
-Die Click-Funktion verwendet den via SendMode gesetzten Send-Modus. Um diesen Modus für einen bestimmten Mausklick zu überschreiben, verwenden Sie eine spezielle Send-Funktion in Kombination mit {Click}, wie z.B.: SendEvent "{Click 100 200}".
Die Click-Funktion verwendet den via SendMode gesetzten Send-Modus. Um diesen Modus für einen bestimmten Mausklick zu überschreiben, verwenden Sie eine spezielle Send-Funktion in Kombination mit {Click}, wie zum Beispiel: SendEvent "{Click 100 200}".
Zum Erzeugen eines via UMSCHALT oder STRG modifizierten Klicks ist das Klicken via Send generell die einfachste Methode. Zum Beispiel:
Send "+{Click 100 200}" ; UMSCHALT+MAUSTASTE-LINKS
Send "^{Click 100 200 Right}" ; STRG+MAUSTASTE-RECHTS
-Im Gegensatz zu Send wird die Click-Funktion die Modifikatortasten (Strg, Alt, Umschalt und Win) nicht automatisch loslassen. Hält man beispielsweise Strg gedrückt, würde Click einen via STRG modifizierten Klick erzeugen, während Send "{Click}" einen normalen Klick erzeugen würde.
Im Gegensatz zu Send lässt die Click-Funktion die Modifikatortasten (Strg, Alt, Umschalt und Win) nicht automatisch los. Hält man beispielsweise Strg gedrückt, würde Click einen via STRG modifizierten Klick erzeugen, während Send "{Click}" einen normalen Klick erzeugen würde.
Der SendPlay-Modus ist im Gegensatz zu den anderen Modi erfolgreicher darin, Mausereignisse in Videospielen zu erzeugen. Außerdem können einige Anwendungen und Videospiele Schwierigkeiten haben, dem Mauszeiger zu folgen, wenn er zu schnell bewegt wird. In diesem Fall kann SetDefaultMouseSpeed helfen, um die Geschwindigkeit zu verringern (allerdings nur im SendEvent-Modus).
Die BlockInput-Funktion kann verwendet werden, um zu verhindern, dass physische Mausaktivitäten des Benutzers die künstlich erzeugten Mausereignisse stören. Allerdings ist das bei den Modi SendInput und SendPlay nicht notwendig, weil sie die physischen Mausaktivitäten des Benutzers automatisch hinauszögern.
Nach jedem DOWN- und UP-Ereignis eines Mausklicks erfolgt automatisch eine Verzögerung (außer im SendInput-Modus und beim Drehen des Mausrads). Mit SetMouseDelay kann die Verzögerungsdauer geändert werden.
diff --git a/target/docs/lib/ClipWait.htm b/target/docs/lib/ClipWait.htm index d1132712..e5d31f07 100644 --- a/target/docs/lib/ClipWait.htm +++ b/target/docs/lib/ClipWait.htm @@ -41,10 +41,10 @@Rückgabewert
Diese Funktion gibt 0 (false) zurück, wenn die Funktion das Zeitlimit überschritten hat, andernfalls 1 (true) (also wenn die Zwischenablage Daten enthält).
Bemerkungen
-Es ist besser, diese Funktion zu verwenden, als mit einer eigenen Schleife zu prüfen, ob die Zwischenablage leer ist. Der Vorteil dieser Funktion ist, dass sie nie die Zwischenablage öffnet, was sie performanter macht und die Möglichkeit ausschließt, mit anderen Anwendungen in Konflikt zu geraten, die ebenfalls auf die Zwischenablage zugreifen.
-Diese Funktion behandelt alles, was in Text umgewandelt werden kann (z.B. HTML), als Text. Dateien, die z.B. mit Strg+C innerhalb eines Explorer-Fensters kopiert werden, werden ebenfalls als Text behandelt. Solche Dateien werden jedes Mal, wenn die Clipboard-Variable im Skript abgerufen wird, in ihre Dateinamen umgewandelt (mit vollständigem Pfad). Weitere Informationen finden Sie unter A_Clipboard.
+Es ist besser, diese Funktion zu verwenden, als mit einer eigenen Schleife zu prüfen, ob die Zwischenablage leer ist. Die Funktion hat den Vorteil, dass die Zwischenablage nie geöffnet wird, was die Performanz verbessert und das Risiko von Konflikten mit anderen Anwendungen, die ebenfalls auf die Zwischenablage zugreifen, verringert.
+Diese Funktion behandelt alles, was in Text umgewandelt werden kann (z.B. HTML), als Text. Dateien, die z.B. mit Strg+C innerhalb eines Explorer-Fensters kopiert werden, werden ebenfalls als Text behandelt. Solche Dateien werden automatisch in ihre Dateinamen (mit vollständigem Pfad) umgewandelt, wann immer im Skript auf die Clipboard-Variable zugegriffen wird. Weitere Informationen finden Sie unter A_Clipboard.
Wenn der letzte Parameter 1 ist, wird die Funktion bereits zufriedengestellt, wenn irgendetwas in der Zwischenablage erscheint. Das ist in Verbindung mit ClipboardAll nützlich, um textlose Elemente wie z.B. Bilder zu speichern.
-Während die Funktion im Wartezustand ist, können neue Threads via Hotkeys, benutzerdefinierte Menüpunkte oder Timer gestartet werden.
+Während die Funktion wartet, können neue Threads via Hotkeys, benutzerdefinierte Menüpunkte oder Timer gestartet werden.
Siehe auch
diff --git a/target/docs/lib/ClipboardAll.htm b/target/docs/lib/ClipboardAll.htm index 07b4bf41..7baedc5a 100644 --- a/target/docs/lib/ClipboardAll.htm +++ b/target/docs/lib/ClipboardAll.htm @@ -2,7 +2,7 @@ClipboardAll
-Erstellt ein Objekt, das alles von der Zwischenablage enthält (z.B. Bilder und Formatierung).
+Erstellt ein Objekt, das alles, was sich in der Zwischenablage befindet, enthält, wie Bilder und Formatierungen.
ClipGesichert := ClipboardAll(Daten, Größe)-
ClipboardAll selbst ist eine von Buffer abstammende Klasse.
ClipboardAll selbst ist eine Klasse, die von Buffer abgeleitet ist.
Parameter
Wenn beide Parameter weggelassen werden, wird der aktuelle Inhalt der Zwischenablage abgerufen. Andernfalls geben Sie einen oder beide Parameter an, um ein Objekt zu erstellen, das die angegebenen Binärdaten der Zwischenablage enthält.
@@ -24,29 +24,29 @@Parameter
Ein Buffer-ähnliches Objekt oder ein reiner Integer, der die Adresse von Binärdaten ist. Die Daten müssen in einem bestimmten Format sein, das in der Regel ein vorheriger Aufruf von ClipboardAll hervorbringt. Schauen Sie sich das Beispiel #2 unten an.
+Ein Buffer-ähnliches Objekt oder ein reiner Integer, der die Adresse der Binärdaten ist. Die Daten müssen in einem bestimmten Format vorliegen, d.h. sie stammen typischerweise von einem früheren Aufruf von ClipboardAll. Siehe Beispiel #2 unten.
Typ: Integer
-Die Anzahl der Bytes, die die Daten enthalten. Dieser Parameter ist optional, wenn Daten ein Objekt ist.
+Die Anzahl der zu verwendeten Bytes. Dies ist optional, wenn Daten ein Objekt ist.
Rückgabewert
Typ: Objekt
-Diese Funktion gibt ein ClipboardAll-Objekt zurück, das zwei Eigenschaften hat (geerbt von Buffer):
+Diese Funktion gibt ein ClipboardAll-Objekt mit den folgenden zwei Eigenschaften zurück (geerbt von Buffer):
-
-
- Ptr: Die Adresse der Daten, die im Objekt enthalten sind. Diese Adresse ist solange gültig, bis das Objekt freigegeben wird. -
- Size: Die Größe der rohen Binärdaten, in Bytes. +
- Ptr: Die Adresse der im Objekt enthaltenen Daten. Diese Adresse verliert ihre Gültigkeit, wenn das Objekt freigegeben wird. +
- Size: Die Größe der rohen Binärdaten in Bytes.
Bemerkungen
Die interne Variable A_Clipboard spiegelt den aktuellen Inhalt der Windows-Zwischenablage in Textform wider, kann aber einem ClipboardAll-Objekt zugewiesen werden, um ihren Inhalt in die Zwischenablage zurückzuschreiben.
-ClipboardAll wird häufig verwendet, um den aktuellen Inhalt der Zwischenablage zu sichern, damit die Zwischenablage vorübergehend für eine andere Operation verwendet werden kann. Sobald die Operation abgeschlossen wurde, kann der originale Inhalt der Zwischenablage wiederhergestellt werden, wie in Beispiel #1 und Beispiel #2 gezeigt.
+ClipboardAll wird häufig verwendet, um den aktuellen Inhalt der Zwischenablage zu sichern, damit die Zwischenablage vorübergehend für eine andere Operation verwendet werden kann. Nach Abschluss der Operation kann der ursprüngliche Inhalt der Zwischenablage wiederhergestellt werden, wie in Beispiel #1 und Beispiel #2 gezeigt.
Wenn ClipboardAll nicht in der Lage ist, bestimmte Datenobjekte (Formate) aus der Zwischenablage abzurufen, werden diese übersprungen und der Rest wird gespeichert.
Mit ClipWait kann festgestellt werden, wann die Zwischenablage Daten enthält (optional auch Nicht-Text-Daten).
-Die im Objekt enthaltenen Binärdaten bestehen aus mehreren Teilen: Die ersten 4 Bytes enthalten den Formattyp, die nächsten 4 Bytes die Datenblockgröße und zum Schluss den Datenblock des Formats. Wenn die Zwischenablage mehr als ein Format enthält (was fast immer der Fall ist), werden diese drei Elemente wiederholt, bis alle Formate enthalten sind. Anschließend enden die Daten mit einem Formattyp (4 Byte groß), wobei jedoch eine 0 enthalten ist.
+Die im Objekt enthaltenen Binärdaten bestehen aus drei Elementen: Die ersten 4 Bytes enthalten den Formattyp, die nächsten 4 Bytes die Datenblockgröße und der Rest den Datenblock des Formats. Wenn die Zwischenablage mehr als ein Format enthält (was fast immer der Fall ist), werden diese drei Elemente wiederholt, bis alle Formate enthalten sind. Die Daten enden mit einem vier Byte großen Formattyp von 0.
Siehe auch
A_Clipboard, ClipWait, OnClipboardChange, #ClipboardTimeout, Buffer
@@ -56,23 +56,23 @@Beispiele
Speichert den Inhalt der Zwischenablage in eine Variable und stellt ihn wieder her.
ClipSicherung := ClipboardAll() ; Zwischenablage in eine beliebige Variable speichern. -; ... hier kann man kurzzeitig die Zwischenablage nutzen, um z.B. schnell eine große Textmenge einzufügen ... -A_Clipboard := ClipSicherung ; Originale Zwischenablage wiederherstellen. Beachten Sie, dass A_Clipboard verwendet wurde (nicht ClipboardAll). +; ... hier die Zwischenablage für etwas anderes verwenden, z.B. schnell eine große Textmenge einfügen ... +A_Clipboard := ClipSicherung ; Originale Zwischenablage wiederherstellen. Beachten Sie die Verwendung von A_Clipboard (nicht ClipboardAll). ClipSicherung := "" ; Speicher freigeben, falls die Zwischenablage sehr groß war.
Speichert den Inhalt der Zwischenablage in eine Datei und stellt ihn wieder her.
-; Option 1: Lösche die Datei, falls vorhanden, und benutze dann FileAppend. +; Option 1: Datei löschen und FileAppend verwenden. FileDelete "Firmenlogo.clip" FileAppend ClipboardAll(), "Firmenlogo.clip" ; Die Dateiendung ist egal. -; Option 2: Benutze FileOpen im Überschreibmodus und File.RawWrite. +; Option 2: FileOpen im Überschreibmodus und File.RawWrite verwenden. ClipDaten := ClipboardAll() FileOpen("Firmenlogo.clip", "w").RawWrite(ClipDaten)Um die Datei später wieder in die Zwischenablage (oder in eine Variable) zu laden, gehen Sie wie folgt vor:
-ClipDaten := FileRead("Firmenlogo.clip", "RAW") ; In diesem Fall gibt FileRead ein Buffer-Objekt zurück. -A_Clipboard := ClipboardAll(ClipDaten) ; Wandelt das Buffer-Objekt in ein ClipboardAll-Objekt um und weist es zu.+ClipDaten := FileRead("Firmenlogo.clip", "RAW") ; In diesem Fall gibt FileRead ein Buffer zurück. +A_Clipboard := ClipboardAll(ClipDaten) ; Wandelt das Buffer in ein ClipboardAll um und weist es zu.
ComCall
-Ruft eine native COM-Interface-Methode über ihre Indexnummer auf.
+Ruft eine native COM-Interface-Methode per Index auf.
Ergebnis := ComCall(Index, ComObj , Typ1, Arg1, Typ2, Arg2, RückgabeTyp)
Parameter
@@ -24,17 +24,17 @@Parameter
Typ: Integer
Die nullbasierte Indexnummer der Methode innerhalb der virtuellen Funktionstabelle.
-Index entspricht der Position der Methode innerhalb der ursprünglichen Interface-Definition. Die Microsoft-Dokumentation listet Methoden grundsätzlich in alphabetischer Reihenfolge auf und ist demzufolge nicht zum Ermitteln der Indexnummer geeignet. Um die richtige Indexnummer zu ermitteln, müssen Sie die ursprüngliche Interface-Definition lokalisieren. Dies könnte z.B. in einer Header-Datei oder einer Typenbibliothek sein.
-Es ist wichtig, Methoden zu berücksichtigen, die von übergeordneten Interfaces geerbt wurden. Da alle COM-Interfaces letztlich von IUnknown abgeleitet sind, sind die ersten drei Methoden immer QueryInterface (0), AddRef (1) und Release (2). Zum Beispiel ist IShellItem2 eine Erweiterung von IShellItem, die bei Index 3 beginnt und 5 Methoden enthält, demzufolge ist die erste Methode von IShellItem2 bei Index 8.
-Tipp: COM-Interfaces, die von Microsoft bereitgestellt werden, finden Sie im Internet oder Windows SDK unter "IInterfaceNameVtbl" - zum Beispiel "IUnknownVtbl". Die Microsoft-eigenen Interface-Definitionen werden von dieser Plain-C-Definition der virtuellen Funktionstabelle des Interfaces begleitet, die alle Methoden explizit in der richtigen Reihenfolge auflistet.
+Index entspricht der Position der Methode innerhalb der ursprünglichen Interface-Definition. Die Microsoft-Dokumentation listet Methoden grundsätzlich in alphabetischer Reihenfolge auf und eignet sich daher nicht zur Ermittlung der Indexnummer. Um die richtige Indexnummer zu ermitteln, muss die ursprüngliche Interface-Definition lokalisiert werden. Dies kann z.B. in einer Header-Datei oder einer Typbibliothek sein.
+Es ist wichtig, Methoden zu berücksichtigen, die von übergeordneten Interfaces geerbt wurden. Da alle COM-Interfaces letztlich von IUnknown abgeleitet sind, sind die ersten drei Methoden immer QueryInterface (0), AddRef (1) und Release (2). Zum Beispiel ist IShellItem2 eine Erweiterung von IShellItem, die bei Index 3 beginnt und 5 Methoden enthält, daher ist die erste Methode von IShellItem2 bei Index 8.
+Tipp: Die von Microsoft definierten COM-Interfaces finden Sie im Internet oder Windows SDK unter "IInterfaceNameVtbl" - zum Beispiel "IUnknownVtbl". Die Microsoft-eigenen Interface-Definitionen werden von dieser Plain-C-Definition der virtuellen Funktionstabelle des Interfaces begleitet, die alle Methoden explizit auflistet, in korrekter Reihenfolge.
Die Übergabe einer ungültigen Indexnummer kann zu undefiniertem Verhalten führen, inklusive (aber nicht beschränkt auf) Programmterminierung.
Typ: Integer, ComValue oder Objekt
-Das gewünschte COM-Objekt; also ein COM-Interface-Pointer. Der Pointer-Wert kann direkt übergeben oder innerhalb eines Objekts mit der Ptr-Eigenschaft gekapselt werden, wie z.B. ein ComValue mit dem Variantentyp VT_UNKNOWN.
Der Interface-Pointer dient zum Lokalisieren der Adresse der virtuellen Funktion, die die Interface-Methode implementiert, und wird auch als Parameter übergeben. Diesen Parameter findet man grundsätzlich nicht in Sprachen, die von sich aus Interfaces unterstützen, allerdings wird er in der C-Style-"Vtbl"-Definition angezeigt.
+Das gewünschte COM-Objekt; also ein COM-Interface-Pointer. Der Pointer-Wert kann direkt übergeben werden oder innerhalb eines Objekts mit der Ptr-Eigenschaft gekapselt sein, wie z.B. ein ComValue mit dem Variantentyp VT_UNKNOWN.
Der Interface-Pointer dient zur Lokalisierung der Adresse der virtuellen Funktion, die die Interface-Methode implementiert, und wird auch als Parameter übergeben. Dieser Parameter ist grundsätzlich nicht explizit in Sprachen enthalten, die Interfaces nativ unterstützen, wird aber in der C-Style-Definition "Vtbl" angezeigt.
Die Übergabe eines ungültigen Pointers kann zu undefiniertem Verhalten führen, inklusive (aber nicht beschränkt auf) Programmterminierung.
Parameter
Typ: Zeichenkette
-Wenn weggelassen, wird standardmäßig HRESULT verwendet, was der häufigste Rückgabetyp für COM-Interface-Methoden ist. Jedes Ergebnis, das auf einen Fehler hinweist, führt dazu, dass ein OSError ausgelöst wird; daher darf der Rückgabetyp nur weggelassen werden, wenn der eigentliche Rückgabetyp HRESULT ist.
-Wenn die Methode vom Typ ist, der keinen Wert zurückgibt (der Rückgabetyp void in C), können Sie "Int" oder einen anderen numerischen Typ ohne Suffix (außer HRESULT) angeben und den Rückgabewert ignorieren. Da der Inhalt des Rückgabewertregisters in solchen Fällen willkürlich ist, wird eventuell eine Ausnahme ausgelöst, wenn RückgabeTyp weggelassen wird.
Wenn weggelassen, wird standardmäßig HRESULT verwendet, was der häufigste Rückgabetyp für COM-Interface-Methoden ist. Jedes Ergebnis, das auf einen Fehler hinweist, bewirkt, dass ein OSError ausgelöst wird, daher darf der Rückgabetyp nur weggelassen werden, wenn der tatsächliche Rückgabetyp HRESULT ist.
+Wenn die Methode vom Typ ist, der keinen Wert zurückgibt (der Rückgabetyp void in C), können Sie "Int" oder einen anderen numerischen Typ ohne Suffix (außer HRESULT) angeben und den Rückgabewert ignorieren. Da der Inhalt des Rückgabewertregisters in diesem Fall willkürlich ist, kann durch Weglassen von RückgabeTyp eine Ausnahme ausgelöst werden.
Andernfalls geben Sie einen der Argumenttypen aus der DllCall-Typentabelle an. Das Sternchen-Suffix wird ebenfalls unterstützt.
-Obwohl ComCall das Schlüsselwort Cdecl gemäß DllCall unterstützt, wird es in der Regel nicht von COM-Interface-Methoden verwendet.
+Obwohl ComCall das Schlüsselwort Cdecl gemäß DllCall unterstützt, wird es grundsätzlich nicht von COM-Interface-Methoden verwendet.
Siehe auch
Beispiele
Entfernt für 3 Sekunden das aktive Fenster aus der Taskleiste. Vergleichen Sie dies mit dem äquivalenten DllCall-Beispiel.
+Entfernt das aktive Fenster für 3 Sekunden aus der Taskleiste. Äquivalent zum DllCall-Beispiel.
/* Methoden in der ITaskbarList-VTable: IUnknown: @@ -94,7 +94,7 @@Beispiele
IID_ITaskbarList := "{56FDF342-FD6D-11d0-958A-006097C9A090}" CLSID_TaskbarList := "{56FDF344-FD6D-11d0-958A-006097C9A090}" -; Erstellt das TaskbarList-Objekt. +; Das TaskbarList-Objekt erstellen. tbl := ComObject(CLSID_TaskbarList, IID_ITaskbarList) activeHwnd := WinExist("A") @@ -104,14 +104,14 @@Beispiele
Sleep 3000 ComCall(4, tbl, "ptr", activeHwnd) ; tbl.AddTab(activeHwnd) -; Wenn mit dem Objekt fertig, ersetze einfach alle Referenzen mit -; einem anderen Wert (oder wenn es sich um eine lokale Variable handelt, einfach return): +; Wenn das Objekt nicht mehr benötigt wird, einfach alle Referenzen mit +; einem anderen Wert ersetzen (oder return bei einer lokalen Variable): tbl := ""
Demonstriert einige Techniken zum Wrappen von COM-Interfaces. Äquivalent zum vorherigen Beispiel.
+Zeigt einige Techniken zum Wrappen von COM-Interfaces. Äquivalent zum vorherigen Beispiel.
tbl := TaskbarList() @@ -130,20 +130,20 @@Beispiele
; Wird beim Start aufgerufen, um die Klasse zu initialisieren. static __new() { - ; Ermittelt das Basisobjekt für alle Instanzen der TaskbarList. + ; Basisobjekt für alle Instanzen von TaskbarList abrufen. proto := this.Prototype - ; Bound-Funktionen können verwendet werden, um Parameter vorab zu definieren, - ; was die Methoden benutzerfreundlicher macht, ohne dass Wrapper-Funktionen erforderlich sind. + ; Mit Bound-Funktionen können Parameter vordefiniert werden, wodurch die + ; Methoden besser nutzbar werden, ohne Hilfe von Wrapper-Funktionen. ; HrInit selbst hat keine Parameter, also nur den Index binden, - ; und der Aufrufer wird implizit 'this' bereitstellen. + ; und der Aufrufer wird implizit 'this' übergeben. proto.HrInit := ComCall.Bind(3) - ; Lassen Sie einen Parameter leer, damit der Aufrufer einen Wert bereitstellen kann. - ; In diesem Fall ist der leere Parameter 'this' (normalerweise versteckt). + ; Parameter leer lassen, um den Aufrufer einen Wert übergeben zu lassen. + ; In diesem Fall ist der leere Parameter 'this' (i.d.R. versteckt). proto.AddTab := ComCall.Bind(4,, "ptr") - ; Ein Object- oder Map-Objekt kann verwendet werden, um Wiederholungen zu reduzieren. + ; Mit Object oder Map können Wiederholungen reduziert werden. for name, args in Map( "DeleteTab", [5,,"ptr"], "ActivateTab", [6,,"ptr"], @@ -156,7 +156,7 @@Beispiele
__new() { this.comobj := ComObject(TaskbarList.CLSID, TaskbarList.IID) this.ptr := this.comobj.ptr - ; Initialisierung über ITaskbarList anfordern. + ; Initialisierung via ITaskbarList anfordern. this.HrInit() } } diff --git a/target/docs/lib/ComObjActive.htm b/target/docs/lib/ComObjActive.htm index d422e009..0b56f19c 100644 --- a/target/docs/lib/ComObjActive.htm +++ b/target/docs/lib/ComObjActive.htm @@ -39,11 +39,11 @@Siehe auch
Beispiele
-diff --git a/target/docs/lib/ComObjArray.htm b/target/docs/lib/ComObjArray.htm index 57d16ca9..b16759b8 100644 --- a/target/docs/lib/ComObjArray.htm +++ b/target/docs/lib/ComObjArray.htm @@ -16,7 +16,7 @@Zeigt das aktive Dokument in Microsoft Word an, sofern das Programm läuft. Einzelheiten über das hier verwendete COM-Objekt und dessen Eigenschaften finden Sie unter Word.Application object (Microsoft Docs).
+Zeigt das aktive Dokument in Microsoft Word an, wenn es gerade läuft. Details zum hier verwendeten COM-Objekt und dessen Eigenschaften finden Sie unter Word.Application object (Microsoft Docs).
word := ComObjActive("Word.Application") if !word - MsgBox "Word ist nicht offen." + MsgBox "Word ist nicht geöffnet." else MsgBox word.ActiveDocument.FullNameComObjArray
Erstellt ein SafeArray, das für COM verwendet werden kann.
ArrayObj := ComObjArray(VarTyp, Anzahl1 , Anzahl2, ... Anzahl8)-+
ComObjArrayselbst ist eine vonComValueabstammende Klasse, wird aber nur zum Erstellen oder Identifizieren von SafeArray-Wrapper-Objekten verwendet.
ComObjArrayselbst ist eine Klasse, die vonComValueabgeleitet ist, aber nur zum Erstellen oder Identifizieren von SafeArray-Wrapper-Objekten verwendet wird.Parameter
-
@@ -25,7 +25,7 @@
-
Typ: Integer
Der Basistyp des Arrays (der VARTYPE jedes Array-Elements). Der VARTYPE ist auf eine Teilmenge der Variantentypen beschränkt. Weder das VT_ARRAY- noch das VT_BYREF-Flag können gesetzt werden. VT_EMPTY und VT_NULL sind keine gültigen Basistypen für das Array. Alle anderen Typen sind zulässig. -Eine Liste möglicher Werte finden Sie unter ComObjType().
+Eine Liste möglicher Werte finden Sie unter ComObjType.
- AnzahlN @@ -41,14 +41,14 @@
.MaxIndex(n): Gibt die Obergrenze der n-ten Dimension zurück. Wenn n weggelassen wird, wird standardmäßig 1 verwendet..MinIndex(n): Gibt die Untergrenze der n-ten Dimension zurück. Wenn n weggelassen wird, wird standardmäßig 1 verwendet..Clone(): Gibt eine Kopie des Arrays zurück.
- .__Enum(): Wird üblicherweise nicht vom Skript aufgerufen; ermöglicht es, For-Schleifen in Kombination mit SafeArrays zu verwenden.
+ .__Enum(): Wird üblicherweise nicht via Skript aufgerufen; ermöglicht die Nutzung von For-Schleifen mit SafeArrays.-
Typ: ComObject
Ein Objekt, das Ereignisse auslöst.
-Wenn das Objekt das IConnectionPointContainer-Interface nicht unterstützt oder wenn Typinformationen über die Klasse des Objekts nicht abgerufen werden können, wird eine Fehlermeldung angezeigt. Mit Try/Catch kann dies unterdrückt oder kontrolliert werden.
+Wenn das Objekt das IConnectionPointContainer-Interface nicht unterstützt oder wenn Typinformationen über die Klasse des Objekts nicht abgerufen werden können, wird eine Fehlermeldung angezeigt. Diese Fehlermeldung kann mit Try/Catch unterdrückt oder behandelt werden.
Das IProvideClassInfo-Interface wird verwendet, um Typinformationen über die Klasse des Objekts abzurufen, sofern es vom Objekt unterstützt wird. Andernfalls versucht ComObjConnect, die Typinformationen via IDispatch-Interface des Objekts abzurufen, was unzuverlässig sein kann.
- PräfixOderSink
-
Typ: Zeichenkette oder Objekt
-Wenn weggelassen, wird die Verbindung zu diesem Objekt getrennt, d.h. das Skript erhält keine Benachrichtigungen von seinen Ereignissen mehr. Andernfalls geben Sie eine Zeichenkette an, die dem Ereignisnamen vorangestellt wird, um zu bestimmen, welche globale Funktion aufgerufen werden soll, wenn ein Ereignis stattfindet, oder ein Event-Sink-Objekt, das eine statische Methode für jedes zu behandelnde Ereignis definiert.
-Hinweis: Verschachtelte Funktionen werden in diesem Modus nicht unterstützt, da Namen erst nach Rückkehr der aktuellen Funktion aufgelöst werden können. Um verschachtelte Funktionen oder Closures zu nutzen, verbinden Sie diese mit einem Objekt und übergeben Sie das Objekt wie unten beschrieben.
+Wenn weggelassen, wird die Verbindung zum Objekt getrennt, d.h. das Skript erhält keine Benachrichtigungen von seinen Ereignissen mehr. Andernfalls geben Sie eine Zeichenkette an, die dem Ereignisnamen vorangestellt wird, um zu bestimmen, welche globale Funktion aufgerufen werden soll, wenn ein Ereignis stattfindet, oder ein Event-Sink-Objekt, das eine statische Methode für jedes zu behandelnde Ereignis definiert.
+Hinweis: Verschachtelte Funktionen werden in diesem Modus nicht unterstützt, da Namen erst nach Rückkehr der aktuellen Funktion aufgelöst werden können. Um verschachtelte Funktionen oder Closures zu verwenden, binden Sie diese an ein Objekt und übergeben Sie das Objekt wie unten beschrieben.
Parameter
Rückgabewert
Diese Funktion gibt ein Wrapper-Objekt zurück, das ein neues SafeArray enthält.
Methoden
-ComObjArray-Objekte unterstützen folgende Methoden:
+ComObjArray-Objekte unterstützen die folgenden Methoden:
Diese sind derzeit hartkodiert; sie existieren nicht als Eigenschaften und werden von Änderungen an ComObjArray.Prototype nicht beeinflusst.
Diese sind derzeit hartkodiert; sie existieren nicht als Eigenschaften und werden nicht durch Änderungen an ComObjArray.Prototype beeinflusst.
Bemerkungen
ComObjArray-Objekte können auch von COM-Methoden und ComValue zurückgegeben werden. Skripte können wie folgt prüfen, ob ein Wert ein ComObjArray ist:
@@ -58,13 +58,13 @@Bemerkungen
else MsgBox "Kein Array." -; Prüfen, ob VT_ARRAY vorhanden ist +; Prüfen, ob VT_ARRAY existiert if ComObjType(obj) & 0x2000 MsgBox "obj ist ein ComObjArray" ; Bestimmten Array-Typ prüfen if ComObjType(obj) = 0x2008 - MsgBox "obj ist ein ComObjArray mit Zeichenketten" + MsgBox "obj ist ein ComObjArray von Zeichenketten"Es werden Arrays mit bis zu 8 Dimensionen unterstützt.
Da SafeArrays nicht für die Unterstützung von Mehrfachreferenzen ausgelegt sind, wird beim Zuweisen eines SafeArrays an ein Element eines anderen SafeArrays eine separate Kopie erstellt. Dies geschieht jedoch nur, wenn das Wrapper-Objekt das F_OWNVALUE-Flag hat, um zu kennzeichnen, dass es für die Zerstörung des Arrays verantwortlich ist. Dieses Flag kann mit ComObjFlags entfernt werden.
Wenn eine via COM-Client aufgerufene Funktion oder Methode ein SafeArray mit dem F_OWNVALUE-Flag zurückgibt, wird eine Kopie erstellt und stattdessen zurückgegeben, da das originale SafeArray automatisch zerstört wird.
diff --git a/target/docs/lib/ComObjConnect.htm b/target/docs/lib/ComObjConnect.htm index 2cdfc2ab..36d1c771 100644 --- a/target/docs/lib/ComObjConnect.htm +++ b/target/docs/lib/ComObjConnect.htm @@ -22,28 +22,28 @@Parameter
Verwendung
Um ComObjConnect effektiv nutzen zu können, müssen Sie zunächst Funktionen in das Skript schreiben, die die entsprechenden Ereignisse behandeln können. Solche Funktionen, auch "Ereignishandler" genannt, haben die folgende Struktur:
-PräfixEreignisname([Params..., ComObj]) +PräfixEreignisName([Params..., ComObj]) { ... ereignisbehandelnder Code ... return RückgabeWert }Präfix sollte identisch mit dem PräfixOderSink-Parameter sein, wenn es eine Zeichenkette ist, andernfalls sollte es weggelassen werden. EreignisName sollte mit dem Namen des Ereignisses ersetzt werden, das von der Funktion behandelt werden soll.
-Params entspricht den Parametern, die das Ereignis hat. Wenn das Ereignis keine Parameter hat, sollte Params ganz weggelassen werden. ComObj ist ein zusätzlicher Parameter, der eine Referenz zum ursprünglichen Wrapper-Objekt, das an ComObjConnect übergeben wurde, enthält; dieser Parameter wird in der Dokumentation des COM-Ereignisses nie erwähnt. "ComObj" sollte mit einem Namen ersetzt werden, der eher dem Kontext Ihres Skripts entspricht.
+Params entspricht den Parametern, die das Ereignis hat. Wenn das Ereignis keine Parameter hat, sollte Params ganz weggelassen werden. ComObj ist ein zusätzlicher Parameter, der eine Referenz zum ursprünglichen Wrapper-Objekt enthält, das an ComObjConnect übergeben wurde; dieser Parameter wird in der Dokumentation des COM-Ereignisses nie erwähnt. "ComObj" sollte mit einem Namen ersetzt werden, der besser zum Kontext Ihres Skripts passt.
Beachten Sie, dass Ereignishandler Rückgabewerte haben können. Mit ComValue kann ein COM-spezifischer Wertetyp zurückgegeben werden. Zum Beispiel gibt
return ComValue(0,0)eine Variante des Typs VT_EMPTY zurück, was dasselbe ist wie, als würde eine JavaScript-Funktionundefined(oder gar nichts) zurückgeben.Mit
ComObjConnect(MeinObjekt, "Präfix")kann die Ereignisbehandlung aktiviert werden.Rufen Sie
@@ -53,11 +53,11 @@ComObjConnect(MeinObjekt)auf, um die Verbindung zum Objekt zu trennen (Ereignisbehandlungen zu stoppen).Event-Sink
Wenn PräfixOderSink ein Objekt ist, wird jedes Mal, wenn ein Ereignis ausgelöst wird, die entsprechende Methode dieses Objekts aufgerufen. Obwohl das Objekt dynamisch konstruiert werden kann, ist es für PräfixOderSink typischer, auf eine Klasse oder eine Instanz einer Klasse zu verweisen. In diesem Fall werden die Methoden wie oben definiert, jedoch ohne Präfix.
Wie bei jedem Methodenaufruf enthält der (normalerweise versteckte)
this-Parameter der Methode eine Referenz zum Objekt, über das die Methode aufgerufen wurde; also das Event-Sink-Objekt, nicht das COM-Objekt. Dies kann verwendet werden, um den Ereignishandlern Kontext bereitzustellen oder um Werte zwischen ihnen auszutauschen.Um alle Ereignisse abzufangen, ohne für jedes einzelne eine Methode zu definieren, definieren Sie eine __Call-Metafunktion.
-ComObject gibt seine Referenz zu PräfixOderSink automatisch frei, wenn das COM-Objekt die Verbindung freigibt. Das passiert zum Beispiel, wenn der Internet Explorer beendet wird. Wenn das Skript seine eigene Referenz zu PräfixOderSink nicht beibehält, kann es __Delete nutzen, um zu erkennen, wann dies geschieht. Wenn das Objekt von einem Remote-Prozess gehostet wird und der Prozess unerwartet terminiert wird, kann es mehrere Minuten dauern, bis das System die Verbindung freigibt.
+ComObject gibt seine Referenz zu PräfixOderSink automatisch frei, wenn das COM-Objekt die Verbindung freigibt. Das passiert zum Beispiel, wenn der Internet Explorer beendet wird. Wenn das Skript seine eigene Referenz zu PräfixOderSink nicht beibehält, kann es __Delete verwenden, um zu erkennen, wann dies geschieht. Wenn das Objekt von einem Remote-Prozess gehostet wird und der Prozess unerwartet terminiert wird, kann es mehrere Minuten dauern, bis das System die Verbindung freigibt.
Bemerkungen
-Das Skript muss eine Referenz zu ComObj behalten, da ComObject sonst automatisch freigegeben und von dessen COM-Objekt getrennt werden würde, wodurch die Erkennung weiterer Ereignisse verhindert wird. Es gibt keine Standardmethode, um zu erkennen, wann die Verbindung nicht mehr benötigt wird, daher muss das Skript die Verbindung manuell trennen, indem es ComObjConnect aufruft.
-Die Persistent-Funktion ist eventuell vonnöten, um das Skript am Laufen zu halten, während es auf Ereignisse wartet.
+Das Skript muss eine Referenz zu ComObj behalten, andernfalls würde es automatisch freigegeben und die Verbindung zu seinem COM-Objekt trennen, was verhindert, dass weitere Ereignisse erkannt werden. Es gibt keine Standardmethode, um zu erkennen, wann die Verbindung nicht mehr benötigt wird, daher muss das Skript die Verbindung manuell trennen, indem es ComObjConnect aufruft.
+Möglicherweise ist die Persistent-Funktion erforderlich, um das Skript am Laufen zu halten, während es auf Ereignisse wartet.
Bei Misserfolg wird eine Ausnahme ausgelöst.
Siehe auch
diff --git a/target/docs/lib/ComObjFlags.htm b/target/docs/lib/ComObjFlags.htm index 70d7ba3e..3053c447 100644 --- a/target/docs/lib/ComObjFlags.htm +++ b/target/docs/lib/ComObjFlags.htm @@ -56,14 +56,14 @@Flags
1 F_OWNVALUE
-SafeArray: Wenn das Flag gesetzt ist, wird das SafeArray bei Freigabe des Wrapper-Objekts zerstört. Da SafeArrays keinen Mechanismus zum Zählen von Referenzen haben, wird, wenn ein SafeArray mit diesem Flag einem Element eines anderen SafeArrays zugewiesen wird, eine separate Kopie erstellt.
-BSTR: Wenn das Flag gesetzt ist, wird der BSTR bei Freigabe des Wrapper-Objekts freigegeben. Das Flag wird automatisch gesetzt, wenn ein BSTR als Ergebnis einer Typenumwandlung, die von ComValue durchgeführt wurde, reserviert wird, wie z.B. bei
+ComValue(8, "Beispiel").SafeArray: Wenn das Flag gesetzt ist, wird das SafeArray beim Freigeben des Wrapper-Objekts zerstört. Da SafeArrays keinen Mechanismus zum Zählen von Referenzen haben, wird, wenn ein SafeArray mit diesem Flag einem Element eines anderen SafeArrays zugewiesen wird, eine separate Kopie erstellt.
+BSTR: Wenn das Flag gesetzt ist, wird der BSTR beim Freigeben des Wrapper-Objekts freigegeben. Das Flag wird automatisch gesetzt, wenn ein BSTR als Ergebnis einer Typenumwandlung, die von ComValue durchgeführt wurde, reserviert wird, z.B.
ComValue(8, "Beispiel").
Bemerkungen
-Wenn Maske weggelassen wird, können Flags via NeueFlags hinzugefügt (falls positiv) oder entfernt (falls negativ) werden. Zum Beispiel entfernt ComObjFlags(obj, -1) das F_OWNVALUE-Flag. Geben Sie für Maske keinen anderen Wert als 0 oder 1 an; alle anderen Bits sind für zukünftige Verwendung reserviert.
Wenn Maske weggelassen wird, können Flags via NeueFlags hinzugefügt (falls positiv) oder entfernt (falls negativ) werden. Zum Beispiel entfernt ComObjFlags(obj, -1) das F_OWNVALUE-Flag. Geben Sie für Maske keinen anderen Wert als 0 oder 1 an; alle anderen Bits sind für zukünftige Zwecke reserviert.
Siehe auch
ComValue, ComObjActive, ComObjArray
diff --git a/target/docs/lib/ComObjFromPtr.htm b/target/docs/lib/ComObjFromPtr.htm index d4b3082d..e7aa3ea3 100644 --- a/target/docs/lib/ComObjFromPtr.htm +++ b/target/docs/lib/ComObjFromPtr.htm @@ -2,7 +2,7 @@ComObjFromPtr
-Wrappt einen rohen IDispatch-Interface-Pointer (COM-Objekt), um ihn für das Skript nutzbar zu machen.
+Wrappt einen rohen IDispatch-Interface-Pointer (COM-Objekt), damit er vom Skript verwendet werden kann.
ComObj := ComObjFromPtr(DispPtr)
Parameter
@@ -31,11 +31,11 @@Parameter
Rückgabewert
Typ: ComObject
Gibt ein Wrapper-Objekt zurück, das den Variantentyp VT_DISPATCH und den angegebenen Pointer enthält.
-Ein Skript kann deutlich besser mit einem COM-Objekt interagieren (via Objektsyntax), wenn es gewrappt wurde. Die meisten Skripte müssen dies nicht manuell tun, weil ComObject, ComObjActive, ComObjGet und andere COM-Methoden, die ein Objekt zurückgeben, automatisch ein Wrapper-Objekt erstellen.
+Das Wrappen eines COM-Objekts ermöglicht dem Skript eine natürlichere Interaktion mit diesem mittels Objektsyntax. Die meisten Skripte müssen dies jedoch nicht manuell tun, da ComObject, ComObjActive, ComObjGet und andere COM-Methoden, die ein Objekt zurückgeben, automatisch ein Wrapper-Objekt erstellen.
Bemerkungen
-Das Wrapper-Objekt übernimmt die Verantwortung für die automatische Freigabe des Pointers, falls erforderlich. Diese Funktion versucht, das IDispatch-Interface des Objekts anzufordern; bei Erfolg wird DispPtr sofort freigegeben. Wenn das Skript also beabsichtigt, den Pointer nach dem Aufruf dieser Funktion weiter zu verwenden, muss es zuerst ObjAddRef(DispPtr) aufrufen.
Bekannte Einschränkung: Jedes Mal, wenn ein COM-Objekt gewrappt wird, wird ein neues Wrapper-Objekt erstellt. Bei Vergleichen und Zuweisungen wie obj1 == obj2 und array[obj1] := Wert werden beide Wrapper-Objekte nicht als identisch angesehen, sogar dann, wenn sie das gleiche COM-Objekt enthalten.
Das Wrapper-Objekt übernimmt die Verantwortung für die automatische Freigabe des Pointers, falls erforderlich. Diese Funktion versucht, das IDispatch-Interface des Objekts anzufordern; bei Erfolg wird DispPtr sofort freigegeben. Wenn das Skript also den Pointer nach dem Aufruf dieser Funktion weiter verwenden will, muss es zuerst ObjAddRef(DispPtr) aufrufen.
Bekannte Einschränkung: Jedes Mal, wenn ein COM-Objekt gewrappt wird, wird ein neues Wrapper-Objekt erstellt. Vergleiche und Zuweisungen wie obj1 == obj2 und arr[obj1] := Wert behandeln die beiden Wrapper-Objekte als nicht identisch, auch wenn sie dasselbe COM-Objekt enthalten.
Siehe auch
ComObject, ComValue, ComObjGet, ComObjConnect, ComObjFlags, ObjAddRef/ObjRelease, ComObjQuery, GetActiveObject (Microsoft Docs)
diff --git a/target/docs/lib/ComObjQuery.htm b/target/docs/lib/ComObjQuery.htm index da7674ad..b0fb6c59 100644 --- a/target/docs/lib/ComObjQuery.htm +++ b/target/docs/lib/ComObjQuery.htm @@ -54,7 +54,7 @@Rückgabewert
ComValuePtr-Eigenschaft zur Verfügung, mit der das Objekt an DllCall oder ComCall übergeben werden kann.Ptr-Eigenschaft bereit, mit der das Objekt an DllCall oder ComCall übergeben werden kann.Beispiele
pweb := ComObjQuery(pdoc, SID_SWebBrowserApp, IID_IWebBrowserApp) ; WebBrowser-Objekt als IDispatch in verwendbarer Form zurückgeben: - ; Dies funktioniert nur, weil IWebBrowserApp von IDispatch abstammt. - ; pweb wird dessen ptr automatisch freigeben, also AddRef nutzen, um dem entgegenzuwirken. + ; Dies funktioniert nur, da IWebBrowserApp von IDispatch abgeleitet ist. + ; pweb wird seinen ptr automatisch freigeben, daher AddRef verwenden. ObjAddRef(pweb.ptr) static VT_DISPATCH := 9 return ComValue(VT_DISPATCH, pweb.ptr) } -GUID(sGUID) ; Wandelt eine Zeichenkette in eine binäre GUID um und gibt sie via Buffer-Objekt zurück. +GUID(sGUID) ; Wandelt eine Zeichenkette in eine binäre GUID um und gibt sie in einem Buffer zurück. { GUID := Buffer(16, 0) if DllCall("ole32\CLSIDFromString", "WStr", sGUID, "Ptr", GUID) < 0 diff --git a/target/docs/lib/ComObjType.htm b/target/docs/lib/ComObjType.htm index ca5c3d8e..2d161084 100644 --- a/target/docs/lib/ComObjType.htm +++ b/target/docs/lib/ComObjType.htm @@ -83,7 +83,7 @@Allgemeine Bemerkungen
In den meisten Fällen werden Werte, die von einer Methode oder Eigenschaft eines COM-Objekts zurückgegeben werden, in einen für AutoHotkey geeigneten Datentyp umgewandelt. Unbehandelte Typen werden via VariantChangeType in Zeichenketten gezwängt; wenn das fehlschlägt oder der Variantentyp das VT_ARRAY- oder VT_BYREF-Flag enthält, wird stattdessen ein Objekt zurückgegeben, das sowohl den Wert als auch dessen Typ enthält.
Wenn ComObjType(x) einen Integer zurückgibt, enthält x einen COM-Objekt-Wrapper.
Wenn InfoTyp "Name" oder "IID" ist, wird die Typinformation über die Interface-Methode IDispatch::GetTypeInfo abgerufen. Der Variantentyp von ComObj muss VT_DISPATCH sein.
Wenn InfoTyp "Class" oder "CLSID" ist, wird die Typinformation über die Interface-Methode IProvideClassInfo::GetClassInfo abgerufen. Der Variantentyp von ComObj muss VT_DISPATCH oder VT_UNKNOWN sein, und das Objekt muss das IProvideClassInfo-Interface implementieren (einige Objekte tun es nicht).
Wenn InfoTyp "Class" oder "CLSID" ist, wird die Typinformation über die Interface-Methode IProvideClassInfo::GetClassInfo abgerufen. Der Variantentyp von ComObj muss VT_DISPATCH oder VT_UNKNOWN sein, und das Objekt muss das IProvideClassInfo-Interface implementieren (einige Objekte tun das nicht).
Siehe auch
ComObjValue, ComValue, ComObject, ComObjGet, ComObjActive
diff --git a/target/docs/lib/ComObjValue.htm b/target/docs/lib/ComObjValue.htm index 5e37f51b..1b38ab47 100644 --- a/target/docs/lib/ComObjValue.htm +++ b/target/docs/lib/ComObjValue.htm @@ -37,7 +37,7 @@Fehlerbehandlung
Bemerkungen
Diese Funktion ist nicht für den allgemeinen Gebrauch gedacht.
-Der Aufruf von ComObjValue ist äquivalent zu variant.llVal, wo ComObj als VARIANT-Struktur behandelt wird. Jedes Skript, das diese Funktion verwendet, muss darauf achten, welchen Wertetyp das Wrapper-Objekt enthält und wie es behandelt werden soll. Wenn zum Beispiel ein Interface-Pointer zurückgegeben wird, sollte Release nicht aufgerufen werden, aber AddRef könnte erforderlich sein, je nachdem, was das Skript mit dem Pointer macht.
Der Aufruf von ComObjValue ist äquivalent zu variant.llVal, wobei ComObj als VARIANT-Struktur behandelt wird. Jedes Skript, das diese Funktion verwendet, muss darauf achten, welchen Wertetyp das Wrapper-Objekt enthält und wie es behandelt werden soll. Wenn zum Beispiel ein Interface-Pointer zurückgegeben wird, sollte Release nicht aufgerufen werden, aber AddRef könnte erforderlich sein, je nachdem, was das Skript mit dem Pointer macht.
Siehe auch
ComObjType, ComObject, ComObjGet, ComObjActive
diff --git a/target/docs/lib/ComObject.htm b/target/docs/lib/ComObject.htm index b2996dd6..a7fbce77 100644 --- a/target/docs/lib/ComObject.htm +++ b/target/docs/lib/ComObject.htm @@ -15,7 +15,7 @@ComObject
Erstellt ein COM-Objekt.
ComObj := ComObject(CLSID , IID)-
ComObject selbst ist eine von ComValue abstammende Klasse, wird aber nur zum Erstellen oder Identifizieren von COM-Objekten verwendet.
ComObject selbst ist eine Klasse, die von ComValue abgeleitet ist, aber nur zum Erstellen oder Identifizieren von COM-Objekten verwendet wird.
Parameter
-
@@ -29,7 +29,7 @@
- IID
-
Typ: Zeichenkette
-Ein Interface-Identifikator, der zurückgegeben werden soll. In den meisten Fällen wird dieser Parameter weggelassen; wenn weggelassen, wird standardmäßig
+"{00020400-0000-0000-C000-000000000046}"(IID_IDispatch) verwendet.Wenn weggelassen, wird standardmäßig
"{00020400-0000-0000-C000-000000000046}"(IID_IDispatch) verwendet. Andernfalls geben Sie den Identifikator eines Interfaces an, das zurückgegeben werden soll. In den meisten Fällen wird dies weggelassen.
Parameter
Rückgabewert
ComValuePtr-Eigenschaft zur Verfügung, mit der das Objekt an DllCall oder ComCall übergeben werden kann.Ptr-Eigenschaft bereit, mit der das Objekt an DllCall oder ComCall übergeben werden kann.Fehlerbehandlung
-Bei Misserfolg wird eine Ausnahme ausgelöst, z.B. wenn ein Parameter ungültig ist oder das Objekt nicht das via IID spezifizierte Interface unterstützt.
+Bei Misserfolg wird eine Ausnahme ausgelöst, z.B. wenn ein Parameter ungültig ist oder das Objekt nicht das angegebene Interface in IID unterstützt.
Siehe auch
ComValue, ComObjGet, ComObjActive, ComObjConnect, ComObjArray, ComObjQuery, ComCall, CreateObject (Microsoft Docs)
@@ -69,7 +69,7 @@Beispiele
Ermittelt den Pfad des aktuellen Desktophintergrunds (Wallpaper).
+Ruft den Pfad des aktuellen Hintergrundbildes (Wallpaper) auf dem Desktop ab.
AD_GETWP_BMP := 0 AD_GETWP_LAST_APPLIED := 0x00000002 diff --git a/target/docs/lib/ComValue.htm b/target/docs/lib/ComValue.htm index 4b1249f5..3ab819a3 100644 --- a/target/docs/lib/ComValue.htm +++ b/target/docs/lib/ComValue.htm @@ -2,7 +2,7 @@ComValue - Syntax & Verwendung | AutoHotkey v2 - + @@ -14,9 +14,9 @@ComValue
-Wrappt ein Wert, SafeArray oder COM-Objekt, um es für das Skript oder für eine COM-Methode nutzbar zu machen.
+Wrappt einen Wert, ein SafeArray oder ein COM-Objekt, damit er/es vom Skript verwendet oder an eine COM-Methode übergeben werden kann.
ComObj := ComValue(VarTyp, Wert , Flags)-+
ComValueselbst ist eine vonAnyabstammende Klasse, wird aber nur zum Erstellen oder Identifizieren von COM-Wrapper-Objekten verwendet.
ComValueselbst ist eine Klasse, die vonAnyabgeleitet ist, aber nur zum Erstellen oder Identifizieren von COM-Wrapper-Objekten verwendet wird.Parameter
-
@@ -30,62 +30,62 @@
- Wert
-
Ein Wert, der gewrappt werden soll.
-Handelt es sich hierbei um einen reinen Integer und ist VarTyp weder VT_R4, VT_R8, VT_DATE noch VT_CY, wird dessen Wert direkt verwendet; insbesondere können VT_BSTR, VT_DISPATCH und VT_UNKNOWN mit einem Pointer-Wert initialisiert werden.
-In allen anderen Fällen wird der Wert in eine temporäre VARIANT kopiert, unter Nutzung der gleichen Regeln wie bei normalen COM-Methodenaufrufen. Wenn der Typ der ursprünglichen Variante ungleich VarTyp ist, wird die Konvertierung durch Aufrufen von VariantChangeType mit einem wFlags-Wert von 0 versucht. Es wird eine Ausnahme ausgelöst, wenn die Konvertierung scheitert.
+Wenn dies ein reiner Integer ist und wenn VarTyp nicht VT_R4, VT_R8, VT_DATE oder VT_CY ist, wird dessen Wert direkt verwendet; insbesondere können VT_BSTR, VT_DISPATCH und VT_UNKNOWN mit einem Pointer-Wert initialisiert werden.
+In allen anderen Fällen wird der Wert in eine temporäre VARIANT kopiert, wobei dieselben Regeln wie bei normalen COM-Methodenaufrufen gelten. Wenn der Quellvariantentyp ungleich VarTyp ist, wird die Umwandlung durch Aufruf von VariantChangeType mit einem wFlags-Wert von 0 versucht. Es wird eine Ausnahme ausgelöst, wenn die Umwandlung scheitert.
- Flags
-
Typ: Integer
-Flags haben Einfluss auf das Verhalten des Wrapper-Objekts; siehe ComObjFlags, um mehr darüber zu erfahren.
+Flags haben Einfluss auf das Verhalten des Wrapper-Objekts; siehe ComObjFlags für weitere Informationen.
Parameter
Rückgabewert
Typ: ComValue, ComValueRef, ComObjArray oder ComObject
-Gibt ein Wrapper-Objekt zurück, das einen Variantentyp und Wert, oder einen Pointer enthält.
-Dieses Objekt ist vielseitig einsetzbar:
+Gibt ein Wrapper-Objekt zurück, das einen Variantentyp und einen Wert oder Pointer enthält.
+Dieses Objekt kann vielseitig verwendet werden:
-
-
- Einige COM-Methoden erfordern möglicherweise bestimmte Wertetypen, die kein direktes Äquivalent innerhalb von AutoHotkey haben. Diese Funktion ermöglicht es, den Typ eines Wertes bei der Übergabe an eine COM-Methode anzugeben. Zum Beispiel erstellt
ComValue(0xB, true)ein Objekt, das den booleschen COM-Wert True repräsentiert.
- - Ein Skript kann deutlich besser mit einem COM-Objekt oder SafeArray interagieren (via Objektsyntax), wenn es gewrappt wurde. Die meisten Skripte müssen dies nicht manuell tun, weil ComObject, ComObjArray, ComObjActive, ComObjGet und andere COM-Methoden, die ein Objekt zurückgeben, automatisch ein Wrapper-Objekt erstellen. -
- Das Skript profitiert von einer automatischen Referenzzählung, wenn ein COM-Interface-Pointer gewrappt wurde. Ein Interface-Pointer kann sofort nach der Rückgabe an das Skript (üblicherweise von ComCall oder DllCall) gewrappt werden, damit er später nicht explizit freigegeben werden muss. +
- Einige COM-Methoden können bestimmte Wertetypen benötigen, die kein direktes Äquivalent in AutoHotkey haben. Diese Funktion ermöglicht es, den Typ eines Wertes anzugeben, wenn er an eine COM-Methode übergeben wird. Zum Beispiel erstellt
ComValue(0xB, true)ein Objekt, das den booleschen COM-Wert True repräsentiert.
+ - Das Wrappen eines COM-Objekts oder SafeArrays ermöglicht dem Skript eine natürlichere Interaktion mit diesem mittels Objektsyntax. Die meisten Skripte müssen dies jedoch nicht manuell tun, da ComObject, ComObjArray, ComObjActive, ComObjGet und andere COM-Methoden, die ein Objekt zurückgeben, automatisch ein Wrapper-Objekt erstellen. +
- Durch das Wrappen eines COM-Interface-Pointers kann das Skript von der automatischen Referenzzählung profitieren. Ein Interface-Pointer kann sofort gewrappt werden, nachdem er an das Skript zurückgegeben wurde (typischerweise von ComCall oder DllCall), wodurch die Notwendigkeit einer expliziten Freigabe zu einem späteren Zeitpunkt vermieden wird.
Ptr
-Wenn der VarTyp eines Wrapper-Objekts VT_UNKNOWN (13) ist oder den VT_BYREF- (0x4000) oder VT_ARRAY-Flag (0x2000) enthält, kann die Ptr-Eigenschaft verwendet werden, um die Adresse des Objekts, der typisierten Variable oder des SafeArrays abzurufen. Dadurch kann das ComObject selbst an jeden DllCall- oder ComCall-Parameter übergeben werden, der vom Typ "Ptr" ist, oder explizit verwendet werden. Zum Beispiel ist ComObj.Ptr in solchen Fällen äquivalent zu ComObjValue(ComObj).
Wenn der VarTyp eines Wrapper-Objekts VT_UNKNOWN (13) oder VT_DISPATCH (9) ist und der gewrappte Pointer Null (0) ist, kann die Ptr-Eigenschaft verwendet werden, um den aktuellen Null-Wert abzurufen oder um dem Wrapper-Objekt einen Pointer zuzuweisen. Nach der Zuweisung (falls ungleich Null) wird der Pointer automatisch freigegeben, wenn das Wrapper-Objekt freigegeben wird. Dies kann zusammen mit DllCall- oder ComCall-Ausgabeparametern vom Typ "Ptr*" oder "PtrP" verwendet werden, um sicherzustellen, dass der Pointer automatisch freigegeben wird, z.B. wenn ein Fehler auftritt. Ein Beispiel dazu finden Sie unter ComObjQuery.
Wenn einem Wrapper-Objekt mit VarTyp VT_DISPATCH (9) und einem Null-Pointer (0) ein Pointer-Wert ungleich Null zugewiesen wird, ändert sich dessen Typ von ComValue zu ComObject. Die Eigenschaften und Methoden des gewrappten Objekts werden verfügbar gemacht, während die Ptr-Eigenschaft nicht mehr zur Verfügung steht.
Wenn der VarTyp eines Wrapper-Objekts VT_UNKNOWN (13) ist oder den VT_BYREF- (0x4000) oder VT_ARRAY-Flag (0x2000) enthält, kann mit der Ptr-Eigenschaft die Adresse des Objekts, die typisierte Variable oder das SafeArray abgerufen werden. Auf diese Weise kann das ComObject selbst an einen DllCall- oder ComCall-Parameter vom Typ "Ptr" übergeben oder explizit verwendet werden. Zum Beispiel ist ComObj.Ptr in solchen Fällen äquivalent zu ComObjValue(ComObj).
Wenn der VarTyp eines Wrapper-Objekts VT_UNKNOWN (13) oder VT_DISPATCH (9) ist und der gewrappte Pointer Null (0) ist, kann mit der Ptr-Eigenschaft der aktuelle Null-Wert abgerufen oder dem Wrapper-Objekt ein Pointer zugewiesen werden. Wenn der Pointer einmal zugewiesen wurde (falls ungleich Null), wird er beim Freigeben des Wrapper-Objekts automatisch freigegeben. Dies kann zusammen mit DllCall- oder ComCall-Ausgabeparametern vom Typ "Ptr*" oder "PtrP" verwendet werden, um sicherzustellen, dass der Pointer automatisch freigegeben wird, z.B. wenn ein Fehler auftritt. Ein Beispiel dazu finden Sie unter ComObjQuery.
Wenn einem Wrapper-Objekt mit VarTyp VT_DISPATCH (9) und einem Null-Pointer (0) ein Pointer-Wert ungleich Null zugewiesen wird, ändert sich dessen Typ von ComValue zu ComObject. Die Eigenschaften und Methoden des gewrappten Objekts werden verfügbar, während die Ptr-Eigenschaft nicht mehr verfügbar ist.
ByRef
Wenn der VarTyp eines Wrapper-Objekts das VT_BYREF-Flag (0x4000) enthält, können leere eckige Klammern [] zum Lesen oder Schreiben des referenzierten Wertes verwendet werden.
Beim Erstellen einer Referenz muss Wert die Speicheradresse einer Variable oder eines Pufferspeichers mit ausreichender Kapazität zur Aufbewahrung eines Wertes bestimmten Typs sein. Das folgende Beispiel erstellt eine Variable, die von einer VBScript-Funktion beschrieben werden kann:
vbuf := Buffer(24, 0)
-vref := ComValue(0x400C, vbuf.ptr) ; 0x400C ist eine Kombination aus VT_BYREF und VT_VARIANT.
+vref := ComValue(0x400C, vbuf.ptr) ; 0x400C ist eine Kombination von VT_BYREF und VT_VARIANT.
vref[] := "Eingabewert"
sc.Run("Beispiel", vref) ; sc sollte wie im Beispiel unten initialisiert werden.
MsgBox vref[]
Beachten Sie, dass, obwohl alle vorherigen Werte freigegeben werden, wenn ein neuer Wert mittels vref[] oder der COM-Methode zugewiesen wird, der finale Wert nicht automatisch freigegeben wird. Um den Wert freizugeben, muss man wissen, um welchen Typ es sich handelt. Da es sich in diesem Fall um VT_VARIANT handelt, kann der Wert durch Aufruf von VariantClear mit DllCall oder durch Nutzung einer einfacheren Methode freigegeben werden: weisen Sie einen Integer zu, z.B. vref[] := 0.
Wenn die Methode wie oben gezeigt eine Kombination aus VT_BYREF und VT_VARIANT akzeptiert, kann stattdessen eine VarRef verwendet werden. Zum Beispiel:
+Wenn die Methode eine Kombination von VT_BYREF und VT_VARIANT akzeptiert, wie oben gezeigt, kann stattdessen eine VarRef verwendet werden. Zum Beispiel:
eine_var := "Eingabewert"
sc.Run("Beispiel", &eine_var)
MsgBox eine_var
-Einige Methoden erfordern jedoch einen spezifischeren Variantentyp, wie z.B. VT_BYREF | VT_I4. In solchen Fällen muss die erste oben gezeigte Vorgehensweise verwendet werden, wobei 0x400C mit dem entsprechenden Variantentyp ersetzt wird.
Einige Methoden erfordern jedoch einen spezifischeren Variantentyp, wie z.B. VT_BYREF | VT_I4. In solchen Fällen muss die erste oben gezeigte Vorgehensweise verwendet und 0x400C mit dem entsprechenden Variantentyp ersetzt werden.
Allgemeine Bemerkungen
-Wenn diese Funktion zum Wrappen eines IDispatch- oder IUnknown-Interface-Pointers (wenn als Integer übergeben) verwendet wird, ist das Wrapper-Objekt zum Freigeben des Pointers verantwortlich, falls erforderlich. Wenn das Skript also beabsichtigt, den Pointer nach dem Aufruf dieser Funktion weiter zu verwenden, muss es zuerst ObjAddRef(DispPtr) aufrufen. Das ist nicht notwendig, wenn Wert selbst ein ComValue oder ComObject ist.
Eine Konvertierung von VT_UNKNOWN nach VT_DISPATCH führt dazu, dass IUnknown::QueryInterface aufgerufen wird und dadurch möglicherweise ein Interface-Pointer erzeugt wird, der vom Original abweicht. Diese Konvertierung löst außerdem eine Ausnahme aus, wenn das Objekt keinen IDispatch implementiert. Handelt es sich bei Wert hingegen um einen Integer und bei VarTyp um VT_DISPATCH, wird der Wert direkt verwendet; in diesem Fall muss der Wert ein IDispatch-kompatibler Interface-Pointer sein.
-Der VarTyp eines Wrapper-Objekts kann via ComObjType abgerufen werden.
-Der Wert eines Wrapper-Objekts kann via ComObjValue abgerufen werden.
-Bekannte Einschränkung: Jedes Mal, wenn ein COM-Objekt gewrappt wird, wird ein neues Wrapper-Objekt erstellt. Bei Vergleichen und Zuweisungen wie obj1 == obj2 und array[obj1] := Wert werden beide Wrapper-Objekte nicht als identisch angesehen, sogar dann, wenn sie denselben Variantentyp und Wert enthalten.
Wenn diese Funktion zum Wrappen eines IDispatch- oder IUnknown-Interface-Pointers (wenn als Integer übergeben) verwendet wird, ist das Wrapper-Objekt für die Freigabe des Pointers verantwortlich, falls erforderlich. Wenn das Skript also den Pointer nach dem Aufruf dieser Funktion weiter verwenden will, muss es zuerst ObjAddRef(DispPtr) aufrufen. Dies ist jedoch nicht notwendig, wenn Wert selbst ein ComValue oder ComObject ist.
Eine Umwandlung von VT_UNKNOWN nach VT_DISPATCH führt dazu, dass IUnknown::QueryInterface aufgerufen wird und dabei ein Interface-Pointer erzeugt werden kann, der vom Original abweicht, und dass eine Ausnahme ausgelöst wird, wenn das Objekt IDispatch nicht implementiert. Wenn dagegen Wert ein Integer und VarTyp VT_DISPATCH ist, wird der Wert direkt verwendet, d.h. der Wert muss ein IDispatch-kompatibler Interface-Pointer sein.
+Der VarTyp eines Wrapper-Objekts kann mit ComObjType abgerufen werden.
+Der Wert eines Wrapper-Objekts kann mit ComObjValue abgerufen werden.
+Bekannte Einschränkung: Jedes Mal, wenn ein COM-Objekt gewrappt wird, wird ein neues Wrapper-Objekt erstellt. Vergleiche und Zuweisungen wie obj1 == obj2 und arr[obj1] := Wert behandeln die beiden Wrapper-Objekte als nicht identisch, auch wenn sie denselben Variantentyp und Wert enthalten.
Siehe auch
ComObjFromPtr, ComObject, ComObjGet, ComObjConnect, ComObjFlags, ObjAddRef/ObjRelease, ComObjQuery, GetActiveObject (Microsoft Docs)
Beispiele
Übergibt VARIANT-ByRef an eine COM-Funktion.
+Übergibt eine VARIANT ByRef an eine COM-Funktion.
; Einleitung - ScriptControl benötigt eine 32-Bit-Version von AutoHotkey. code := " @@ -98,7 +98,7 @@Beispiele
sc := ComObject("ScriptControl"), sc.Language := "VBScript", sc.AddCode(code) -; Beispiel: VARIANT via Referenz an eine COM-Methode übergeben. +; Beispiel: Eine VARIANT ByRef an eine COM-Methode übergeben. var := ComVar() var[] := "Eingabewert" sc.Run("Beispiel", var.ref) @@ -120,7 +120,7 @@Beispiele
MsgBox var -; ComVar: Ein Objekt, mit dem ein Wert via Referenz übergeben werden kann. +; ComVar: Ein Objekt, mit dem ein Wert ByRef übergeben werden kann. ; this[] ruft den Wert ab. ; this[] := Val setzt den Wert. ; this.ref ruft ein ByRef-Objekt zur Übergabe an eine COM-Methode ab. @@ -129,7 +129,7 @@Beispiele
; Speicher für ein VARIANT reservieren, damit unser Wert hineinpasst. VARIANT wird auch dann ; verwendet, wenn vType != VT_VARIANT, damit VariantClear von __delete verwendet werden kann. this.var := Buffer(24, 0) - ; Ein Objekt erstellen, mit dem die Variable via ByRef übergeben werden kann. + ; Ein Objekt erstellen, mit dem die Variable ByRef übergeben werden kann. this.ref := ComValue(0x4000|vType, this.var.ptr + (vType=0xC ? 0 : 8)) ; Variantentyp für VariantClear speichern (wenn nicht VT_VARIANT). if Type != 0xC diff --git a/target/docs/lib/Control.htm b/target/docs/lib/Control.htm index 60af4d91..016c61cd 100644 --- a/target/docs/lib/Control.htm +++ b/target/docs/lib/Control.htm @@ -2,7 +2,7 @@Liste mit Control-Funktionen | AutoHotkey v2 - + @@ -13,7 +13,7 @@Control-Funktionen
-Funktionen zum Abrufen von Informationen über ein Steuerelement, oder zum Modifizieren eines Steuerelements. Klicken Sie auf einen Funktionsnamen, um mehr zu erfahren.
+Funktionen zum Abrufen von Informationen über ein Steuerelement oder zum Modifizieren eines Steuerelements. Klicken Sie auf einen Funktionsnamen, um mehr zu erfahren.
Funktion @@ -21,7 +21,7 @@Control-Funktionen
ControlAddItem -Fügt eine bestimmte Zeichenkette als neuen Listeneintrag an das untere Ende einer ListBox oder ComboBox hinzu. +Fügt einen neuen Listeneintrag zu einer ListBox oder ComboBox hinzu. ControlChooseIndex @@ -41,7 +41,7 @@Control-Funktionen
ControlFindItem -Gibt die Positionsnummer eines ListBox- oder ComboBox-Listeneintrags zurück, der exakt mit einer bestimmten Zeichenkette übereinstimmt. +Gibt die Nummer des ListBox- oder ComboBox-Eintrags zurück, der exakt mit einer Zeichenkette übereinstimmt. ControlFocus @@ -49,11 +49,11 @@Control-Funktionen
ControlGetChecked -Gibt einen Wert ungleich 0 zurück, wenn die CheckBox abgehakt oder der Radio-Button eingeschaltet ist. +Gibt einen Wert ungleich 0 zurück, wenn das CheckBox- oder Radio-Steuerelement eingeschaltet ist. ControlGetChoice -Gibt den Namen des aktuell ausgewählten ListBox- oder ComboBox-Listeneintrags zurück. +Gibt den Namen des aktuell ausgewählten ListBox- oder ComboBox-Eintrags zurück. ControlGetClassNN @@ -65,7 +65,7 @@Control-Funktionen
ControlGetFocus -Ermittelt, welches Steuerelement des Zielfensters den Tastaturfokus hat, falls vorhanden. +Ermittelt, welches Steuerelement im Zielfenster den Tastaturfokus hat, falls vorhanden. ControlGetHwnd @@ -73,11 +73,11 @@Control-Funktionen
ControlGetIndex -Gibt die Indexnummer des aktuell ausgewählten Listeneintrags oder Tabs im ListBox-, ComboBox- oder Tab-Steuerelement zurück. +Gibt die Indexnummer des aktuell ausgewählten Listeneintrags/Tabs im ListBox-, ComboBox- oder Tab-Steuerelement zurück. ControlGetItems -Gibt ein Array mit Einträgen/Zeilen aus einer ListBox, ComboBox oder DropDownList zurück. +Gibt ein Array aller Einträge/Zeilen in einer ListBox, ComboBox oder DropDownList zurück. ControlGetPos @@ -113,7 +113,7 @@Control-Funktionen
ControlSetChecked -Versetzt eine CheckBox oder einen Radio-Button in den abgehakten oder nicht-abgehakten bzw. ein- oder ausgeschalteten Zustand. +Schaltet ein CheckBox- oder Radio-Steuerelement ein oder aus. ControlSetEnabled @@ -121,7 +121,7 @@Control-Funktionen
ControlSetStyle -
ControlSetExStyleÄndert den Style bzw. erweiterten Style eines bestimmten Steuerelements. +Ändert den Style oder erweiterten Style eines bestimmten Steuerelements. ControlSetText @@ -129,7 +129,7 @@Control-Funktionen
ControlShow -Macht ein bestimmtes Steuerelement, das zuvor versteckt wurde, wieder sichtbar. +Macht ein zuvor verstecktes Steuerelement wieder sichtbar. ControlShowDropDown @@ -137,15 +137,15 @@Control-Funktionen
EditGetCurrentCol -Gibt die Spaltennummer in einem Edit-Steuerelement zurück, auf der sich aktuell der Textcursor (Texteinfügemarke) befindet. +Gibt die Nummer der Spalte in einem Edit-Steuerelement zurück, auf der sich der Textcursor (Einfügemarke) aktuell befindet. EditGetCurrentLine -Gibt die Zeilennummer in einem Edit-Steuerelement zurück, auf der sich aktuell der Cursor (Einfügemarke) befindet. +Gibt die Nummer der Zeile in einem Edit-Steuerelement zurück, auf der sich der Textcursor (Einfügemarke) aktuell befindet. EditGetLine -Gibt den Text einer bestimmten Zeile in einem Edit-Steuerelement zurück. +Gibt den Text auf einer bestimmten Zeile in einem Edit-Steuerelement zurück. EditGetLineCount @@ -157,32 +157,32 @@Control-Funktionen
EditPaste -Fügt eine bestimmte Zeichenkette an den Textcursor (Texteinfügemarke) eines Edit-Steuerelements ein. +Fügt eine bestimmte Zeichenkette am Textcursor (Einfügemarke) eines Edit-Steuerelements ein. ListViewGetContent -Gibt eine Liste von Einträgen/Zeilen aus einer ListView zurück. +Gibt eine Liste von Einträgen/Zeilen in einer ListView zurück. Der Steuerelement-Parameter
-Funktionen, die mit einzelnen Steuerelementen agieren, haben einen Parameter namens Steuerelement, der einige verschiedene Möglichkeiten unterstützt, um das Steuerelement zu identifizieren. Der Steuerelement-Parameter kann eines der folgenden Dinge sein:
-ClassNN (Zeichenkette): Die ClassNN-Bezeichnung (Klassenname und Instanznummer) des Steuerelements, die mit dem internen Tool Window Spy ermittelt werden kann. Zum Beispiel ist "Edit1" das erste Steuerelement mit dem Klassennamen "Edit".
+Funktionen, die mit einzelnen Steuerelementen arbeiten, haben einen Parameter namens Steuerelement, der einige verschiedene Möglichkeiten zur Identifizierung des Steuerelements unterstützt. Für den Steuerelement-Parameter kann Folgendes angegeben werden:
+ClassNN (Zeichenkette): Die ClassNN-Bezeichnung (Klassenname und Instanznummer) des Steuerelements, die mit dem internen Tool "Window Spy" ermittelt werden kann. Zum Beispiel ist "Edit1" das erste Steuerelement mit dem Klassennamen "Edit".
Text (Zeichenkette): Der Text des Steuerelements. Das Übereinstimmungsverhalten ist abhängig von SetTitleMatchMode.
HWND (Integer): Die HWND-Nummer (eindeutige ID) des Steuerelements, die üblicherweise via ControlGetHwnd, MouseGetPos oder DllCall abgerufen werden kann. Dies funktioniert auch mit versteckten Steuerelementen, selbst wenn DetectHiddenWindows ausgeschaltet ist. Alle nachfolgenden Fensterparameter werden ignoriert.
-Objekt: Ein Objekt beliebigen Typs, das eine
-Hwnd-Eigenschaft besitzt, wie z.B. GuiControl. Es wird ein PropertyError ausgelöst, wenn das Objekt keineHwnd-Eigenschaft hat, oder TypeError, wenn es keinen reinen Integer zurückgibt. Alle nachfolgenden Fensterparameter werden ignoriert.Weggelassen: Einige Funktionen können entweder mit einem Steuerelement oder Top-Level-Fenster arbeiten. Wenn der Steuerelement-Parameter weggelassen wird, verwendet die Funktion das Zielfenster (angegeben via FensterTitel), anstatt eines seiner Steuerelemente. Zum Beispiel kann ControlSend Tastendrücke direkt an das Fenster senden.
+Objekt: Ein beliebiges Objekt mit einer
+Hwnd-Eigenschaft, wie z.B. ein GuiControl. Es wird ein PropertyError ausgelöst, wenn das Objekt keineHwnd-Eigenschaft hat, oder ein TypeError, wenn es keinen reinen Integer zurückgibt. Alle nachfolgenden Fensterparameter werden ignoriert.Weggelassen: Einige Funktionen können entweder mit einem Steuerelement oder einem Top-Level-Fenster arbeiten. Wenn der Steuerelement-Parameter weggelassen wird, verwendet die Funktion das Zielfenster (angegeben via FensterTitel), anstatt eines seiner Steuerelemente. Zum Beispiel kann ControlSend Tastendrücke direkt an das Fenster senden.
Fehlerbehandlung
-Bei Misserfolg kann typischerweise einer der folgenden Fehler ausgelöst werden:
+Bei Misserfolg wird typischerweise einer der folgenden Fehler ausgelöst:
-
- TargetError: Das angegebene Fenster oder Steuerelement konnte nicht gefunden werden.
-- Error oder OSError: Es gab ein Problem bei der Umsetzung des Zwecks der Funktion, wie das Abrufen einer Einstellung oder das Anwenden einer Änderung.
+- TargetError: Das Zielfenster oder -steuerelement konnte nicht gefunden werden.
+- Error oder OSError: Es gab ein Problem, den Zweck der Funktion zu erfüllen, z.B. eine Einstellung abrufen oder eine Änderung vornehmen.
- ValueError oder TypeError: Es wurden ungültige Parameter erkannt.
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, erfolgt nach jeder Verwendung einer steuerelementmodifizierenden Funktion automatisch eine Verzögerung (außer bei ControlSetStyle und ControlSetExStyle). Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+Um die Zuverlässigkeit zu erhöhen, erfolgt jedes Mal, nachdem eine steuerelementmodifizierende Funktion verwendet wurde, automatisch eine Verzögerung (außer bei ControlSetStyle und ControlSetExStyle). Diese Verzögerung kann mit SetControlDelay oder durch Zuweisung eines Wertes an A_ControlDelay geändert werden. Weitere Informationen finden Sie unter SetControlDelay-Bemerkungen.
Mit MouseGetPos kann die ClassNN-Bezeichnung oder HWND-Nummer (eindeutige ID) des Steuerelements unter dem Mauszeiger abgerufen werden.
Mit WinGetControls oder WinGetControlsHwnd kann eine Liste von Steuerelementen abgerufen werden, die in einem Fenster enthalten sind.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
diff --git a/target/docs/lib/ControlAddItem.htm b/target/docs/lib/ControlAddItem.htm index e2db6699..caf68a9e 100644 --- a/target/docs/lib/ControlAddItem.htm +++ b/target/docs/lib/ControlAddItem.htm @@ -2,7 +2,7 @@ControlAddItem - Syntax & Verwendung | AutoHotkey v2 - + @@ -14,7 +14,7 @@ControlAddItem
-Fügt eine bestimmte Zeichenkette als neuen Listeneintrag an das untere Ende einer ListBox oder ComboBox hinzu.
+Fügt einen neuen Listeneintrag zu einer ListBox oder ComboBox hinzu.
ControlAddItem Zkette, Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText@@ -39,14 +39,14 @@Parameter
Rückgabewert
Typ: Integer
-Diese Funktion gibt die Indexnummer des neuen Listeneintrags zurück, also 1 für den ersten Listeneintrag, 2 für den Zweiten usw.
+Diese Funktion gibt die Indexnummer des neuen Listeneintrags zurück, wobei 1 der erste Listeneintrag, 2 der zweite usw. ist.
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 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 oder OSError ausgelöst, wenn der Listeneintrag nicht hinzugefügt werden konnte.
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlChooseIndex.htm b/target/docs/lib/ControlChooseIndex.htm index 775676d6..56d38f3c 100644 --- a/target/docs/lib/ControlChooseIndex.htm +++ b/target/docs/lib/ControlChooseIndex.htm @@ -23,7 +23,7 @@Parameter
- N
Typ: Integer
-Die Indexnummer des Listeneintrags/Tabs; also 1 für den ersten, 2 für den zweiten usw. Um alle Listeneinträge in einer ListBox oder ComboBox abzuwählen, geben Sie 0 an.
+Die Indexnummer des Listeneintrags/Tabs, wobei 1 der erste Listeneintrag/Tab, 2 der zweite usw. ist. Um alle Listeneinträge in einer ListBox oder ComboBox abzuwählen, geben Sie 0 an.
- Steuerelement
- @@ -38,13 +38,13 @@
Parameter
Fehlerbehandlung
-Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte, oder wenn der Klassenname des Steuerelements weder "Combo", "List" noch "Tab" enthält.
+Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte oder wenn der Klassenname des Steuerelements weder "Combo", "List" noch "Tab" enthält.
Es wird ein Error oder OSError ausgelöst, wenn die Änderung nicht angewendet werden konnte.
Bemerkungen
-Das folgende Beispiel zeigt, wie alle Elemente innerhalb einer Mehrfachauswahl-ListBox ausgewählt werden können:
+Um alle Listeneinträge in einer Mehrfachauswahl-ListBox auszuwählen, gehen Sie wie folgt vor:
PostMessage(0x0185, 1, -1, "ListBox1", FensterTitel) ; Wählt alle ListBox-Einträge aus. 0x0185 ist LB_SETSEL.-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlChooseString.htm b/target/docs/lib/ControlChooseString.htm index a087fe10..0c74b2e7 100644 --- a/target/docs/lib/ControlChooseString.htm +++ b/target/docs/lib/ControlChooseString.htm @@ -39,14 +39,14 @@Parameter
Rückgabewert
Typ: Integer
-Diese Funktion gibt die Indexnummer des ausgewählten Listeneintrags zurück, also 1 für den ersten Listeneintrag, 2 für den Zweiten usw.
+Diese Funktion gibt die Indexnummer des ausgewählten Listeneintrags zurück, wobei 1 der erste Listeneintrag, 2 der zweite usw. ist.
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 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 oder OSError ausgelöst, wenn die Änderung nicht angewendet werden konnte.
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlClick.htm b/target/docs/lib/ControlClick.htm index eca3d00b..c333d7b3 100644 --- a/target/docs/lib/ControlClick.htm +++ b/target/docs/lib/ControlClick.htm @@ -40,7 +40,7 @@Parameter
Typ: Zeichenkette
Wenn leer oder weggelassen, wird standardmäßig Left verwendet (die linke Maustaste). Andernfalls geben Sie die zu klickende Taste oder die Dreh-/Kipprichtung des Mausrads an.
Taste: Left, Right, Middle (oder jeweils nur der erste Buchstabe) oder X1 (vierte Maustaste) oder X2 (fünfte Maustaste).
-Mausrad: Geben Sie WheelUp oder WU an, um das Mausrad nach oben zu drehen (von Ihnen weg); geben Sie WheelDown oder WD an, um es nach unten zu drehen (zu Ihnen hin). Geben Sie WheelLeft (WL) oder WheelRight (WR) an, um das Mausrad nach links bzw. rechts zu drücken. KlicksAnzahl ist die Anzahl der Schritte, um die das Mausrad gedreht werden soll.
+Mausrad: Geben Sie WheelUp oder WU an, um das Mausrad nach oben zu drehen (von Ihnen weg); geben Sie WheelDown oder WD an, um es nach unten zu drehen (zu Ihnen hin). Geben Sie WheelLeft (oder WL) oder WheelRight (oder WR) an, um das Mausrad nach links bzw. rechts zu kippen. KlicksAnzahl ist die Anzahl der Schritte, um die das Mausrad gedreht werden soll.
- KlicksAnzahl
@@ -53,7 +53,7 @@Parameter
Typ: Zeichenkette
Wenn leer oder weggelassen, besteht jeder Klick aus einem Down- und Up-Ereignis, das in der Mitte des Steuerelements erfolgt (sofern Modus 2 verwendet wird). Andernfalls geben Sie eine Zeichenkette an, die aus einer oder mehreren der folgenden Optionen besteht: Zum Beispiel:
-"d x50 y25".NA: Kann die Zuverlässigkeit verbessern. Siehe Zuverlässigkeit weiter unten.
+NA: Kann die Zuverlässigkeit erhöhen. Siehe Zuverlässigkeit weiter unten.
D: Drückt die Maustaste nach unten, ohne sie wieder loszulassen (also ein Down-Ereignis). Fehlt sowohl die D- als auch U-Option, wird ein vollständiger Mausklick gesendet (also ein Down- und Up-Ereignis).
U: Lässt die Maustaste los (also ein Up-Ereignis). Diese Option sollte nicht verwendet werden, wenn die D-Option bereits vorhanden ist (und umgekehrt).
Pos: Geben Sie das Wort Pos in Optionen an, um den X/Y-Positioniermodus zu erzwingen, wie oben im Steuerelement-oder-Pos-Parameter beschrieben.
@@ -69,7 +69,7 @@Fehlerbehandlung
@@ -101,7 +101,7 @@
- TargetError: Das Zielfenster konnte nicht gefunden werden.
- TargetError: Das Zielsteuerelement konnte nicht gefunden werden und Steuerelement-oder-Pos enthält keine gültige Position.
-- OSError (sehr selten): Die X- oder Y-Position wurde weggelassen und die Position des Steuerelements konnte nicht bestimmt werden.
+- OSError (sehr selten): Die X- oder Y-Position wurde weggelassen und die Position des Steuerelements konnte nicht ermittelt werden.
- ValueError oder TypeError: Es wurden ungültige Parameter erkannt.
Beispiele
diff --git a/target/docs/lib/ControlDeleteItem.htm b/target/docs/lib/ControlDeleteItem.htm index 2aba61f0..afd24963 100644 --- a/target/docs/lib/ControlDeleteItem.htm +++ b/target/docs/lib/ControlDeleteItem.htm @@ -23,7 +23,7 @@Klickt im NA-Modus auf Koordinaten relativ zum angegebenen Steuerelement.
-SetControlDelay -1 ; Kann die Zuverlässigkeit verbessern und Nebeneffekte reduzieren. +SetControlDelay -1 ; Kann Zuverlässigkeit erhöhen und Nebeneffekte reduzieren. ControlClick "Toolbar321", "Beliebiger Fenstertitel",,,, "NA x192 y10"Parameter
- N
Typ: Integer
-Die Indexnummer des Listeneintrags, also 1 für den ersten Listeneintrag, 2 für den Zweiten, und so weiter.
+Die Indexnummer des Listeneintrags, wobei 1 der erste Listeneintrag, 2 der zweite usw. ist.
- Steuerelement
- @@ -38,11 +38,11 @@
Parameter
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 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 oder OSError ausgelöst, wenn der Listeneintrag nicht entfernt werden konnte.
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlFindItem.htm b/target/docs/lib/ControlFindItem.htm index 36088ca4..006c8ae2 100644 --- a/target/docs/lib/ControlFindItem.htm +++ b/target/docs/lib/ControlFindItem.htm @@ -2,7 +2,7 @@ControlFindItem - Syntax & Verwendung | AutoHotkey v2 - + @@ -14,7 +14,7 @@ControlFindItem
-Gibt die Positionsnummer eines ListBox- oder ComboBox-Listeneintrags zurück, der exakt mit einer bestimmten Zeichenkette übereinstimmt.
+Gibt die Nummer des ListBox- oder ComboBox-Eintrags zurück, der exakt mit einer Zeichenkette übereinstimmt.
GefundenerEintrag := ControlFindItem(Zkette, Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)@@ -23,7 +23,7 @@Parameter
- Zkette
Typ: Zeichenkette
-Eine Zeichenkette, die gefunden werden soll. Die Suche ist nicht Groß-/Kleinschreibung-sensitiv. Im Gegensatz zu ControlChooseString muss der komplette Text des Eintrags übereinstimmen, nicht nur der beginnende Teil.
+Eine Zeichenkette, die gefunden werden soll. Die Suche ist nicht Groß-/Kleinschreibung-sensitiv. Im Gegensatz zu ControlChooseString muss der gesamte Text des Eintrags übereinstimmen, nicht nur der beginnende Teil.
- Steuerelement
- @@ -39,14 +39,14 @@
Parameter
Rückgabewert
Typ: Integer
-Diese Funktion gibt die Positionsnummer eines ListBox- oder ComboBox-Listeneintrags zurück, der exakt mit Zkette übereinstimmt. Der erste Listeneintrag im Steuerelement ist 1, der zweite 2 und so weiter. Wenn kein einziger Listeneintrag gefunden wurde, wird eine Ausnahme ausgelöst.
+Diese Funktion gibt die Nummer des ListBox- oder ComboBox-Eintrags zurück, der exakt mit Zkette übereinstimmt. Der erste Listeneintrag im Steuerelement ist 1, der zweite 2 und so weiter. Wenn nichts gefunden wurde, wird eine Ausnahme ausgelöst.
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 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.
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlFocus.htm b/target/docs/lib/ControlFocus.htm index e82f059c..bbb3b35d 100644 --- a/target/docs/lib/ControlFocus.htm +++ b/target/docs/lib/ControlFocus.htm @@ -37,7 +37,7 @@Fehlerbehandlung
Bemerkungen
Um den gewünschten Effekt zu erzielen, darf das Fenster des Steuerelements weder minimiert noch versteckt sein.
-Um die Zuverlässigkeit der Funktion zu verbessern, erfolgt jedes Mal, wenn sie durchgeführt wurde, automatisch eine Verzögerung. Diese Verzögerung kann via SetControlDelay geändert werden.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Wenn ein Steuerelement durch eine Benutzereingabe fokussiert wird (z.B. durch Drücken der Tabulatortaste), werden zusätzliche Effekte unabhängig vom fokussierten Steuerelement angewendet. Diese Effekte werden nicht von ControlFocus angewendet, daher gelten die folgenden Einschränkungen:
@@ -47,15 +47,15 @@
Bemerkungen
Die WM_NEXTDLGCTL-Meldung kann verwendet werden, um das Steuerelement zu fokussieren und diese zusätzlichen Effekte anzuwenden. Zum Beispiel:
WinExist("A") ; Macht das aktive Fenster zum zuletzt gefundenen Fenster -ControlGet, StrlmntHwnd, Hwnd,, Button1 ; Holt HWND der ersten Schaltfläche -SendMessage, 0x0028, StrlmntHwnd, True ; 0x0028 ist WM_NEXTDLGCTL+StrlmntHwnd := ControlGetHwnd("Button1") ; Holt HWND der ersten Schaltfläche +SendMessage 0x0028, StrlmntHwnd, True ; 0x0028 ist WM_NEXTDLGCTL
Siehe auch
SetControlDelay, ControlGetFocus, Control-Funktionen
Beispiele
Setzt den Eingabefokus auf die OK-Schaltfläche.
-ControlFocus "OK", "Beliebiger Fenstertitel" ; Setzt den Fokus auf die OK-Schaltfläche+
ControlFocus "OK", "Beliebiger Fenstertitel"
ControlGetChecked
-Gibt einen Wert ungleich 0 zurück, wenn die CheckBox abgehakt oder der Radio-Button eingeschaltet ist.
+Gibt einen Wert ungleich 0 zurück, wenn das CheckBox- oder Radio-Steuerelement eingeschaltet ist.
-IstGesetzt := ControlGetChecked(Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)+
IstEingeschaltet := ControlGetChecked(Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)
Parameter
-
@@ -34,7 +34,7 @@
- Tasten
-
Typ: Zeichenkette
-Eine Reihe von Tasten, die gesendet werden sollen (siehe Send-Funktion für mehr Details). Die Geschwindigkeit, mit welcher die Zeichen gesendet werden, wird durch SetKeyDelay beeinflusst.
+Eine Reihe von Tasten, die gesendet werden sollen (weitere Informationen finden Sie auf der Send-Seite). Die Geschwindigkeit, mit der die Zeichen gesendet werden, wird durch SetKeyDelay beeinflusst.
Im Gegensatz zur Send-Funktion kann ControlSend keine Mausklicks senden. Verwenden Sie stattdessen ControlClick.
@@ -45,9 +45,9 @@
Parameter
Rückgabewert
Typ: Integer (boolesch)
-Diese Funktion gibt 1 (true) zurück, wenn die CheckBox abgehakt oder der Radio-Button eingeschaltet ist, oder 0 (false), wenn nicht.
+Diese Funktion gibt 1 (true) zurück, wenn das CheckBox- oder Radio-Steuerelement eingeschaltet ist, andernfalls 0 (false).
Fehlerbehandlung
Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.
diff --git a/target/docs/lib/ControlGetChoice.htm b/target/docs/lib/ControlGetChoice.htm index f7b5e527..cc450fbb 100644 --- a/target/docs/lib/ControlGetChoice.htm +++ b/target/docs/lib/ControlGetChoice.htm @@ -2,7 +2,7 @@ControlGetChoice
-Gibt den Namen des aktuell ausgewählten ListBox- oder ComboBox-Listeneintrags zurück.
+Gibt den Namen des aktuell ausgewählten ListBox- oder ComboBox-Eintrags zurück.
Auswahl := ControlGetChoice(Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)@@ -34,10 +34,10 @@
Parameter
Rückgabewert
Typ: Zeichenkette
-Diese Funktion gibt den Namen des aktuell ausgewählten ListBox- oder ComboBox-Listeneintrags zurück.
+Diese Funktion gibt den Namen des aktuell ausgewählten ListBox- oder ComboBox-Eintrags zurück.
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 TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte oder wenn der Klassenname des Steuerelements weder "Combo" noch "List" enthält.
Bei Misserfolg wird ein Error ausgelöst.
Bemerkungen
diff --git a/target/docs/lib/ControlGetClassNN.htm b/target/docs/lib/ControlGetClassNN.htm index c5d36a65..f0c2c0d5 100644 --- a/target/docs/lib/ControlGetClassNN.htm +++ b/target/docs/lib/ControlGetClassNN.htm @@ -41,9 +41,9 @@Fehlerbehandlung
Es wird ein Error oder OSError ausgelöst, wenn die ClassNN-Bezeichnung nicht ermittelt werden konnte.
Bemerkungen
-Die ClassNN-Bezeichnung ist der Fensterklassenname eines Steuerelements, gefolgt von dessen 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 dem internen Tool 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 zu ermitteln, übergeben Sie die HWND-Nummer des Steuerelements an WinGetClass.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlGetEnabled.htm b/target/docs/lib/ControlGetEnabled.htm index 688d11cb..f2a14c71 100644 --- a/target/docs/lib/ControlGetEnabled.htm +++ b/target/docs/lib/ControlGetEnabled.htm @@ -34,7 +34,7 @@Parameter
Rückgabewert
Typ: Integer (boolesch)
-Diese Funktion gibt 1 (true) zurück, wenn die Interaktion mit dem angegebenen Steuerelement aktiviert ist, oder 0 (false), wenn nicht.
+Diese Funktion gibt 1 (true) zurück, wenn die Interaktion mit dem angegebenen Steuerelement aktiviert ist, andernfalls 0 (false).
Fehlerbehandlung
Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.
diff --git a/target/docs/lib/ControlGetFocus.htm b/target/docs/lib/ControlGetFocus.htm index 6a4d2e25..13bfc6cc 100644 --- a/target/docs/lib/ControlGetFocus.htm +++ b/target/docs/lib/ControlGetFocus.htm @@ -2,7 +2,7 @@ControlGetFocus
-Ermittelt, welches Steuerelement des Zielfensters den Tastaturfokus hat, falls vorhanden.
+Ermittelt, welches Steuerelement im Zielfenster den Tastaturfokus hat, falls vorhanden.
HWND := ControlGetFocus(FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)
Parameter
@@ -30,15 +30,15 @@Parameter
Rückgabewert
Typ: Integer
Diese Funktion gibt die HWND-Nummer (eindeutige ID) des fokussierten Steuerelements zurück.
-Wenn keines der Steuerelemente im Zielfenster den Tastaturfokus hat, ist der Rückgabewert eine 0.
+Wenn keines der Steuerelemente im Zielfenster den Tastaturfokus hat, wird 0 zurückgegeben.
Fehlerbehandlung
Es wird ein TargetError ausgelöst, wenn das Zielfenster oder Zielsteuerelement nicht ermittelt werden konnte.
Es wird ein OSError ausgelöst, wenn der Fokus nicht ermittelt werden konnte.
Bemerkungen
-Das abgerufene Steuerelement ist auch das Steuerelement, das den Tastaturfokus hat; solche Steuerelemente sind die Anlaufstelle für jegliche Tastendrücke des Benutzers.
-Das Fenster muss aktiv sein, um ein fokussiertes Steuerelement (sofern vorhanden) abrufen zu können.
+Das mit dieser Funktion abgerufene Steuerelement hat den Tastaturfokus, d.h. das Steuerelement ist das Ziel aller Tastendrücke des Benutzers.
+Das Zielfenster muss aktiv sein, um ein fokussiertes Steuerelement zu haben, aber selbst dann ist nicht garantiert, dass es eines hat.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
ControlFocus, Control-Funktionen
diff --git a/target/docs/lib/ControlGetHwnd.htm b/target/docs/lib/ControlGetHwnd.htm index 1c331292..e9fb3ba0 100644 --- a/target/docs/lib/ControlGetHwnd.htm +++ b/target/docs/lib/ControlGetHwnd.htm @@ -40,7 +40,7 @@Fehlerbehandlung
Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.
Bemerkungen
-Die HWND-Nummer (eindeutige ID) eines Steuerelements wird oft in Verbindung mit PostMessage, SendMessage und DllCall verwendet. Die HWND-Nummer eines Steuerelements kann auch via MouseGetPos abgerufen werden. So eine HWND-Nummer kann direkt in einem FensterTitel-Parameter verwendet werden. Dies funktioniert auch mit versteckten Steuerelementen, selbst wenn DetectHiddenWindows ausgeschaltet ist.
+Die HWND-Nummer (eindeutige ID) eines Steuerelements wird oft in Verbindung mit PostMessage, SendMessage und DllCall verwendet. Die HWND-Nummer eines Steuerelements kann auch mit MouseGetPos abgerufen werden. So eine HWND-Nummer kann direkt in einem FensterTitel-Parameter verwendet werden. Dies funktioniert auch mit versteckten Steuerelementen, selbst wenn DetectHiddenWindows ausgeschaltet ist.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlGetIndex.htm b/target/docs/lib/ControlGetIndex.htm index 2045814c..edc3c85e 100644 --- a/target/docs/lib/ControlGetIndex.htm +++ b/target/docs/lib/ControlGetIndex.htm @@ -2,7 +2,7 @@ControlGetIndex
-Gibt die Indexnummer des aktuell ausgewählten Listeneintrags oder Tabs im ListBox-, ComboBox- oder Tab-Steuerelement zurück.
+Gibt die Indexnummer des aktuell ausgewählten Listeneintrags/Tabs im ListBox-, ComboBox- oder Tab-Steuerelement zurück.
Index := ControlGetIndex(Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)@@ -34,10 +34,10 @@
Parameter
Rückgabewert
Typ: Integer
-Diese Funktion gibt die Indexnummer des aktuell ausgewählten Listeneintrags oder Tabs zurück. Der erste Listeneintrag oder Tab ist 1, der Zweite ist 2 und so weiter. Wenn kein Listeneintrag oder Tab ausgewählt wurde, ist der Rückgabewert 0.
+Diese Funktion gibt die Indexnummer des aktuell ausgewählten Listeneintrags/Tabs zurück. Der erste Listeneintrag/Tab ist 1, der zweite 2 und so weiter. Wenn kein Listeneintrag/Tab ausgewählt ist, wird 0 zurückgegeben.
Fehlerbehandlung
-Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte, oder wenn der Klassenname des Steuerelements weder "Combo", "List" noch "Tab" enthält.
+Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte oder wenn der Klassenname des Steuerelements weder "Combo", "List" noch "Tab" enthält.
Es wird ein OSError ausgelöst, wenn eine Meldung nicht an das Steuerelement gesendet werden konnte.
Bemerkungen
@@ -51,7 +51,7 @@Siehe auch
Beispiele
Ruft den aktiven Tab des ersten Tab-Steuerelements ab.
+Ruft die aktive Tabnummer des ersten Tab-Steuerelements ab.
WelcherTab := ControlGetIndex("SysTabControl321", "Beliebiger Fenstertitel")
MsgBox "Tab #" WelcherTab " ist aktiv."
diff --git a/target/docs/lib/ControlGetItems.htm b/target/docs/lib/ControlGetItems.htm
index 15cf5d92..85cc164a 100644
--- a/target/docs/lib/ControlGetItems.htm
+++ b/target/docs/lib/ControlGetItems.htm
@@ -2,7 +2,7 @@
ControlGetItems - Syntax & Verwendung | AutoHotkey v2
-
+
@@ -14,7 +14,7 @@
ControlGetItems
-Gibt ein Array mit Einträgen/Zeilen aus einer ListBox, ComboBox oder DropDownList zurück.
+Gibt ein Array aller Einträge/Zeilen in einer ListBox, ComboBox oder DropDownList zurück.
Einträge := ControlGetItems(Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText)
@@ -33,15 +33,15 @@ Parameter
Rückgabewert
-Typ: Array mit Zeichenketten
-Diese Funktion gibt ein Array zurück, das die Texte aller Listeneinträge/Zeilen enthält.
+Typ: Array von Zeichenketten
+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.
-Bei Misserfolg wird ein Error ausgelöst, z.B. wenn eine Meldung einen Fehlercode zurückgibt oder nicht gesendet werden konnte.
+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 verhindern mit Absicht, dass ihre Listeneinträge nicht abgerufen werden kann. In solchen Fällen wird normalerweise keine Ausnahme ausgelöst, allerdings werden alle Felder abgerufen, als wären sie leer.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlGetStyle.htm b/target/docs/lib/ControlGetStyle.htm
index c3036cb3..96fefc3c 100644
--- a/target/docs/lib/ControlGetStyle.htm
+++ b/target/docs/lib/ControlGetStyle.htm
@@ -2,7 +2,7 @@
ControlGetStyle / ControlGetExStyle - Syntax & Verwendung | AutoHotkey v2
-
+
diff --git a/target/docs/lib/ControlGetText.htm b/target/docs/lib/ControlGetText.htm
index 2272f859..7bef8b27 100644
--- a/target/docs/lib/ControlGetText.htm
+++ b/target/docs/lib/ControlGetText.htm
@@ -42,10 +42,10 @@ Fehlerbehandlung
Bemerkungen
Hinweis: Mit ListViewGetContent oder ControlGetItems können stattdessen Texte aus einer ListView, ListBox oder ComboBox abgerufen werden.
-Wenn der abgerufene Text abgeschnitten (unvollständig) zu sein scheint, kann der Text stattdessen durch Senden der WM_GETTEXT-Meldung via SendMessage abgerufen werden. AutoHotkey macht den Rückgabewert für den Text zu klein, weil die Anwendung, deren Text abgerufen werden soll, nur sporadisch oder gar nicht auf die WM_GETTEXTLENGTH-Meldung reagiert.
-Diese Funktion kann sehr viel Arbeitsspeicher beanspruchen, wenn das Zielsteuerelement eine große Menge an Text beinhaltet (z.B. wenn ein großes Dokument im Texteditor geöffnet wurde). Der Speicher einer Variable kann aber, nachdem sie verwendet wurde, wieder freigegeben werden, indem man ihr einen leeren Wert zuweist, z.B. Text := "".
+Wenn der abgerufene Text gekürzt (unvollständig) ist, kann es erforderlich sein, den Text stattdessen durch Senden der WM_GETTEXT-Meldung via SendMessage abzurufen. Der Grund dafür ist, dass einige Anwendungen nicht richtig auf die WM_GETTEXTLENGTH-Meldung reagieren, wodurch AutoHotkey den Rückgabewert zu klein für den gesamten Text macht.
+Diese Funktion kann sehr viel Arbeitsspeicher beanspruchen, wenn das Zielsteuerelement eine große Menge an Text enthält (z.B. wenn ein großes Dokument in einem Texteditor geöffnet wurde). Allerdings kann der Speicher einer Variable nach ihrer Verwendung wieder freigegeben werden, indem ihr ein leerer Wert zugewiesen wird, d.h. Text := "".
Die meisten Steuerelemente markieren das Ende einer Zeile mit einem CR-LF-Paar (`r`n) anstelle eines einzelnen LF-Zeichens (`n).
-SetTitleMatchMode "Slow" muss nicht gesetzt werden, weil ControlGetText den Text immer mithilfe der langsamen Methode abruft (mit dieser Methode können deutlich mehr Steuerelemente angesteuert werden).
+SetTitleMatchMode "Slow" muss nicht verwendet werden, da ControlGetText den Text immer im langsamen Modus abruft (dieser Modus funktioniert mit viel mehr Steuerelementen).
Mit WinGetControls oder WinGetControlsHwnd kann eine Liste von Steuerelementen abgerufen werden, die in einem Fenster enthalten sind.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlHide.htm b/target/docs/lib/ControlHide.htm
index 9096338c..dcffc3f3 100644
--- a/target/docs/lib/ControlHide.htm
+++ b/target/docs/lib/ControlHide.htm
@@ -37,7 +37,7 @@ Fehlerbehandlung
Bemerkungen
Mit ControlSetEnabled kann zusätzlich der Tastaturkurzbefehl eines Steuerelements (unterstrichene Buchstabe) deaktiviert werden.
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlHideDropDown.htm b/target/docs/lib/ControlHideDropDown.htm
index 0752b114..c71c4773 100644
--- a/target/docs/lib/ControlHideDropDown.htm
+++ b/target/docs/lib/ControlHideDropDown.htm
@@ -40,7 +40,7 @@ Siehe auch
ControlShowDropDown, Control-Funktionen
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Beispiele
diff --git a/target/docs/lib/ControlMove.htm b/target/docs/lib/ControlMove.htm
index ea432baf..b339aa6f 100644
--- a/target/docs/lib/ControlMove.htm
+++ b/target/docs/lib/ControlMove.htm
@@ -50,7 +50,7 @@ Fehlerbehandlung
Bemerkungen
-Um die Zuverlässigkeit der Funktion zu verbessern, erfolgt jedes Mal, wenn sie durchgeführt wurde, automatisch eine Verzögerung. Diese Verzögerung kann via SetControlDelay geändert werden.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlSend.htm b/target/docs/lib/ControlSend.htm
index a14bb74d..614f7503 100644
--- a/target/docs/lib/ControlSend.htm
+++ b/target/docs/lib/ControlSend.htm
@@ -23,7 +23,7 @@ Parameter
Fehlerbehandlung
Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.
Bemerkungen
-ControlSendText sendet die einzelnen Zeichen des Tasten-Parameters, ohne z.B. {Enter} in Enter, ^c in Strg+C usw. zu übersetzen. Weitere Informationen finden Sie unter Text-Modus. {Raw} oder {Text} kann auch bei ControlSend verwendet werden.
Wenn der Steuerelement-Parameter weggelassen wird, versucht diese Funktion, die Tastatureingaben an das oberste Steuerelement (welches oft das Richtige ist) oder, falls keine Steuerelemente vorhanden sind, an das Fenster selbst zu senden. Das ist nützlich, wenn das Fenster keine Steuerelemente zu haben scheint, oder wenn es egal ist, an welches Steuerelement die Tastendrücke gesendet werden.
-Standardmäßig werden Modifikatortastendrücke (Strg, Alt, Umschalt und Win) so gesendet, wie man es von der Send-Funktion gewohnt ist. Dadurch können Konsolenfenster wie die Windows-Eingabeaufforderung Großbuchstaben, Steuerzeichen usw. korrekt erkennen. Dies könnte auch die Zuverlässigkeit in anderen Bereichen verbessern.
+ControlSendText sendet die einzelnen Zeichen des Tasten-Parameters ohne Übersetzung von z.B. {Enter} in Enter, ^c in Strg+C und so weiter. Weitere Informationen finden Sie unter Text-Modus. {Raw} oder {Text} kann auch bei ControlSend verwendet werden.
Wenn der Steuerelement-Parameter weggelassen wird, versucht diese Funktion, die Tastendrücke entweder an das oberste Steuerelement zu senden (welches oft das richtige ist) oder, wenn keine Steuerelemente vorhanden sind, an das Fenster selbst. Das ist nützlich, wenn das Fenster keine Steuerelemente zu haben scheint, oder wenn es egal ist, an welches Steuerelement die Tastendrücke gesendet werden.
+Standardmäßig werden Modifikatoren (Strg, Alt, Umschalt und Win) so gesendet, wie sie normalerweise mit der Send-Funktion gesendet werden würden. Dadurch können Konsolenfenster wie die Windows-Eingabeaufforderung Großbuchstaben, Steuerzeichen usw. korrekt erkennen. Dies könnte auch die Zuverlässigkeit in anderen Bereichen verbessern.
In einigen Fällen können diese Modifikatorereignisse jedoch das aktive Fenster stören, insbesondere dann, wenn der Benutzer während eines ControlSends aktiv schreibt oder wenn Alt gesendet wird (da Alt die Menüleiste des aktiven Fensters aktiviert). Dies lässt sich vermeiden, indem man explizit Up- und Down-Ereignisse des Modifikators sendet. Zum Beispiel:
ControlSend "{Alt down}f{Alt up}", "Edit1", "Unbenannt - Editor"
Die obige Methode erlaubt auch das Senden von Modifikatoren (Strg, Alt, Umschalt und Win), während der PC gesperrt ist (durch die Anmeldeaufforderung geschützt ist).
@@ -57,9 +57,9 @@Bemerkungen
SetKeyDelay 0, 10 SetKeyDelay -1, 0Wenn es sich bei dem Zielsteuerelement um ein Edit-Steuerelement (oder ähnliches) handelt, sind die folgenden Aktionen in der Regel zuverlässiger und schneller als ControlSend:
-EditPaste("Dieser Text wird an der Position des Textcursors eingefügt.", Steuerelementname, FensterTitel)-
ControlSetText("Dieser Text ersetzt vollständig den aktuell vorhandenen Text.", Steuerelementname, FensterTitel)-
ControlSend ist normalerweise nicht in der Lage, die Menüleiste eines Fensters zu manipulieren. Um das zu umgehen, können Sie MenuSelect verwenden. Sollte dies aufgrund der Art der Menüleiste nicht funktionieren, können Sie stattdessen versuchen, die Meldung des gewünschten Menüpunkts mithilfe des SendMessage-Tutorials herauszufinden.
+EditPaste("Dieser Text wird an der Position des Textcursors eingefügt.", SteuerelementName, FensterTitel)+
ControlSetText("Dieser Text wird den bisherigen Text vollständig ersetzen.", SteuerelementName, FensterTitel)+
ControlSend ist normalerweise nicht in der Lage, die Menüleiste eines Fensters zu manipulieren. Um das zu umgehen, verwenden Sie MenuSelect. Sollte dies aufgrund der Art der Menüleiste nicht funktionieren, können Sie stattdessen versuchen, die Meldung des gewünschten Menüpunkts mithilfe des SendMessage-Tutorials herauszufinden.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
SetKeyDelay, Escapesequenzen (z.B. `n) , Control-Funktionen, Send, Winamp automatisieren
@@ -71,9 +71,9 @@Beispiele
; Sendet den Text an das inaktive Notepad-Eingabefeld. ; Der dritte Parameter wurde weggelassen, um das zuletzt gefundene Fenster zu verwenden. ControlSend "Dies ist eine Textzeile in Notepad.{Enter}", "Edit1" -ControlSendText "Man beachte, dass {Enter} nicht als Enter-Tastendruck gesendet wurde.", "Edit1" +ControlSendText "Beachten Sie, dass {Enter} nicht als Enter-Tastendruck gesendet wurde.", "Edit1" -Msgbox "Drücken Sie OK, um das Fenster zu aktivieren und die Ergebnisse zu sehen." +Msgbox "Drücken Sie OK, um das Fenster zu aktivieren und das Ergebnis zu sehen." WinActivate "ahk_pid " PID ; Zeigt das Ergebnis an.Beispiele
MeineGui.Add("Edit", "r10 w500") MeineGui.Show() ControlSend "Dies ist eine Textzeile im Eingabefeld.{Enter}", "Edit1", MeineGui -ControlSendText "Man beachte, dass {Enter} nicht als Enter-Tastendruck gesendet wurde.", "Edit1", MeineGui +ControlSendText "Beachten Sie, dass {Enter} nicht als Enter-Tastendruck gesendet wurde.", "Edit1", MeineGuiControlSetChecked
-Versetzt eine CheckBox oder einen Radio-Button in den abgehakten oder nicht-abgehakten bzw. ein- oder ausgeschalteten Zustand.
+Schaltet ein CheckBox- oder Radio-Steuerelement ein oder aus.
ControlSetChecked NeueEinstellung, Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText@@ -24,7 +24,7 @@
Parameter
Typ: Integer
-Geben Sie einen der folgenden Werte an:
+Einer der folgenden Werte:
1oderTrueschaltet die Einstellung ein0oderFalseschaltet die Einstellung aus
@@ -48,8 +48,8 @@ - NeueEinstellung
-
Typ: Integer
-Geben Sie einen der folgenden Werte an:
+Einer der folgenden Werte:
1oderTrueschaltet die Einstellung ein0oderFalseschaltet die Einstellung aus
@@ -47,7 +47,7 @@
Fehlerbehandlung
Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlSetStyle.htm b/target/docs/lib/ControlSetStyle.htm index c9560b71..b9b942d4 100644 --- a/target/docs/lib/ControlSetStyle.htm +++ b/target/docs/lib/ControlSetStyle.htm @@ -14,7 +14,7 @@ControlSetStyle / ControlSetExStyle
-Ändert den Style bzw. erweiterten Style eines bestimmten Steuerelements.
+Ändert den Style oder erweiterten Style eines bestimmten Steuerelements.
ControlSetStyle Wert, Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText ControlSetExStyle Wert, Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText
@@ -24,31 +24,31 @@Parameter
- Wert
-
Typ: Integer oder Zeichenkette
-Verwenden Sie einen positiven Integer, um den Style des Fensters komplett zu überschreiben; also um den Style auf den angegebenen Wert zu setzen.
-Um Styles auf einfache Weise hinzuzufügen, zu entfernen oder umzuschalten, übergeben Sie eine numerische Zeichenkette, die entweder mit einem Pluszeichen (+), Minuszeichen (-) oder Zirkumflex (^) beginnt. Der neue Style-Wert wird wie folgt berechnet (AktuellerStyle kann mit ControlGetStyle/ControlGetExStyle oder WinGetStyle/WinGetExStyle abgerufen werden):
+Verwenden Sie einen positiven Integer, um den Style des Fensters vollständig zu überschreiben bzw. direkt auf Wert zu setzen.
+Um Styles hinzuzufügen, zu entfernen oder umzuschalten, übergeben Sie eine numerische Zeichenkette, die entweder mit einem Pluszeichen (+), Minuszeichen (-) oder Zirkumflex (^) beginnt. Der neue Style-Wert wird wie folgt berechnet (wobei AktuellerStyle mit ControlGetStyle, ControlGetExStyle, WinGetStyle oder WinGetExStyle abgerufen werden kann):
@@ -69,11 +69,11 @@Operation Präfix -Beispiel-Zeichenkette +Beispiel Formel - Add +Hinzufügen + -+0x80 +"+0x80"NeuerStyle := AktuellerStyle | Wert- Remove +Entfernen - --0x80 +"-0x80"NeuerStyle := AktuellerStyle & ~WertUmschalten ^ -^0x80 +"^0x80"NeuerStyle := AktuellerStyle ^ WertParameter
Fehlerbehandlung
Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.
-Es wird ein OSError ausgelöst, wenn der Style nicht geändert werden konnte. Nur zum Teil durchgeführte Änderungen werden als Erfolg gewertet.
+Es wird ein OSError ausgelöst, wenn der Style nicht geändert werden konnte. Eine Teiländerung wird als Erfolg gewertet.
Bemerkungen
Weitere Styles finden Sie unter Fenster- und Steuerelement-Styles.
-Die Änderungen einiger Styles werden erst wirksam, wenn das komplette Fenster via WinRedraw neu gezeichnet wurde.
+Bestimmte Style-Änderungen werden erst wirksam, wenn das gesamte Fenster via WinRedraw neu gezeichnet wird.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlSetText.htm b/target/docs/lib/ControlSetText.htm index 8dfdfe27..7324114a 100644 --- a/target/docs/lib/ControlSetText.htm +++ b/target/docs/lib/ControlSetText.htm @@ -45,7 +45,7 @@Fehlerbehandlung
Bemerkungen
Die meisten Steuerelemente markieren das Ende einer Zeile mit einem CR-LF-Paar (`r`n) anstelle eines einzelnen LF-Zeichens (`n). Um die `n-Zeichen eines Textblocks mit `r`n zu ersetzen, gehen Sie wie folgt vor:
MeineVar := StrReplace(MeineVar, "`n", "`r`n")
-Um die Zuverlässigkeit der Funktion zu verbessern, erfolgt jedes Mal, wenn sie durchgeführt wurde, automatisch eine Verzögerung. Diese Verzögerung kann via SetControlDelay geändert werden.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlShow.htm b/target/docs/lib/ControlShow.htm index 1b7835db..97211626 100644 --- a/target/docs/lib/ControlShow.htm +++ b/target/docs/lib/ControlShow.htm @@ -2,7 +2,7 @@ControlShow - Syntax & Verwendung | AutoHotkey v2 - + @@ -14,7 +14,7 @@ControlShow
-Macht ein bestimmtes Steuerelement, das zuvor versteckt wurde, wieder sichtbar.
+Macht ein zuvor verstecktes Steuerelement wieder sichtbar.
ControlShow Steuerelement , FensterTitel, FensterText, AusnahmeTitel, AusnahmeText
@@ -36,7 +36,7 @@Fehlerbehandlung
Es wird ein TargetError ausgelöst, wenn das Fenster oder Steuerelement nicht gefunden werden konnte.
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlShowDropDown.htm b/target/docs/lib/ControlShowDropDown.htm index b3524624..ef441c76 100644 --- a/target/docs/lib/ControlShowDropDown.htm +++ b/target/docs/lib/ControlShowDropDown.htm @@ -37,7 +37,7 @@Fehlerbehandlung
Es wird ein OSError ausgelöst, wenn eine Meldung nicht an das Steuerelement gesendet werden konnte.
Bemerkungen
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
@@ -47,7 +47,7 @@Beispiele
diff --git a/target/docs/lib/DetectHiddenText.htm b/target/docs/lib/DetectHiddenText.htm index 99f0b3f7..5361180d 100644 --- a/target/docs/lib/DetectHiddenText.htm +++ b/target/docs/lib/DetectHiddenText.htm @@ -35,15 +35,15 @@Öffnet das Ausführen-Dialogfenster, zeigt dessen Auswahlliste für 2 Sekunden an und schließt das Dialogfenster wieder.
Send "#r" ; Ausführen-Dialogfenster öffnen. -WinWaitActive "ahk_class #32770" ; Wartet auf das Erscheinen des Dialogfensters. +WinWaitActive "ahk_class #32770" ; Auf Erscheinen des Dialogfensters warten. ControlShowDropDown "ComboBox1" ; Auswahlliste anzeigen. Der zweite Parameter wurde weggelassen, um das zuletzt gefundene Fenster zu verwenden. Sleep 2000 ControlHideDropDown "ComboBox1" ; Auswahlliste verstecken. diff --git a/target/docs/lib/CoordMode.htm b/target/docs/lib/CoordMode.htm index 674d8c21..075f2881 100644 --- a/target/docs/lib/CoordMode.htm +++ b/target/docs/lib/CoordMode.htm @@ -46,8 +46,8 @@
Rückgabewert
Diese Funktion gibt die vorherige Einstellung zurück.
Bemerkungen
-Wenn diese Funktion nie verwendet wird, verwenden alle internen Funktionen standardmäßig Koordinaten, die relativ zum Clientbereich des aktiven Fensters sind (außer anderweitig dokumentierte interne Funktionen, wie z.B. WinMove und InputBox).
-Jeder neu gestartete Thread (z.B. ein Hotkey, ein benutzerdefinierter Menüpunkt oder eine zeitgesteuerte Subroutine) verwendet vorerst die Standardeinstellung der Funktion. Um diese zu ändern, nutzen Sie die Funktion während der Startphase des Skripts.
+Wenn diese Funktion nie verwendet wird, verwenden alle internen Funktionen standardmäßig Koordinaten, die relativ zum Clientbereich des aktiven Fensters sind (außer anderweitig dokumentierte interne Funktionen wie WinMove und InputBox).
+Jeder neu gestartete Thread (z.B. ein Hotkey, ein benutzerdefinierter Menüpunkt oder eine zeitgesteuerte Subroutine) verwendet zunächst die Standardeinstellung der Funktion. Diese Standardeinstellung kann geändert werden, indem die Funktion während der Startphase des Skripts verwendet wird.
Die internen A_CoordMode-Variablen enthalten die aktuellen Einstellungen.
Siehe auch
Click, MouseMove, MouseClick, MouseClickDrag, MouseGetPos, PixelGetColor, PixelSearch, ToolTip, Menu.Show
diff --git a/target/docs/lib/Critical.htm b/target/docs/lib/Critical.htm index a85ca960..f168cc55 100644 --- a/target/docs/lib/Critical.htm +++ b/target/docs/lib/Critical.htm @@ -39,16 +39,16 @@Verhalten von kritischen Threads
Ein kritischer Thread wird unterbrechbar, wenn ein Mitteilungsfenster oder ein anderes Dialogfenster angezeigt wird. Im Gegensatz zu Thread Interrupt wird der Thread jedoch wieder kritisch, wenn der Benutzer das Dialogfenster schließt.
Critical Off
-Während gepufferte Ereignisse darauf warten, neue Threads zu starten, ist es nicht möglich,
+Critical "Off"zu nutzen, um eine sofortige Unterbrechung des aktuellen Threads zu bewirken. Stattdessen vergehen durchschnittlich 5 Millisekunden, bevor eine Unterbrechung erfolgt. Somit ist zu 99,999 % sichergestellt, dass mindestens eine Zeile nachCritical "Off"ausgeführt wird, bevor es zu einer Unterbrechung kommt. Mit Mitteln wieSleep -1oder WinWait in Verbindung mit einem noch nicht existierenden Fenster können sofortige Unterbrechungen erzwungen werden.Während gepufferte Ereignisse darauf warten, neue Threads zu starten, ist es nicht möglich, mit
Critical "Off"eine sofortige Unterbrechung des aktuellen Threads zu bewirken. Stattdessen vergehen durchschnittlich 5 Millisekunden, bevor eine Unterbrechung erfolgt. Somit ist zu 99,999 % sichergestellt, dass mindestens eine Zeile nachCritical "Off"ausgeführt wird, bevor es zu einer Unterbrechung kommt. Mit Mitteln wieSleep -1oder WinWait in Verbindung mit einem noch nicht existierenden Fenster können sofortige Unterbrechungen erzwungen werden.Critical "Off"beendet die unterbrechungsfreie Phase des aktuellen Threads, auch wenn der Thread nicht kritisch war, so dass Ereignisse wie Size früher bzw. vorhersehbarer abgearbeitet werden können.Thread-Einstellungen
-Schauen Sie sich A_IsCritical an, wie die aktuelle Einstellung von Critical gespeichert und wiederhergestellt werden kann. Beachten Sie, dass Critical eine threadspezifische Einstellung ist, deshalb wird, wenn ein kritischer Thread endet, der darunter liegende/fortgesetzte Thread (sofern vorhanden) automatisch unkritisch sein. Somit ist es nicht notwendig,
-Critical "Off"kurz vor dem Beenden eines Threads durchzuführen.Wenn Critical vom Auto-Execute-Thread nicht verwendet wird, sind alle Threads zunächst unkritisch (es sei denn, Thread Interrupt wurde verwendet). Wird Critical hingegen vom Auto-Execute-Thread eingeschaltet, aber nie ausgeschaltet, ist jeder neu gestartete Thread (z.B. Hotkey, benutzerdefinierter Menüpunkt oder zeitgesteuerte Subroutine) zunächst kritisch.
+Schauen Sie sich A_IsCritical an, wie die aktuelle Einstellung von Critical gespeichert und wiederhergestellt werden kann. Beachten Sie, dass Critical eine threadspezifische Einstellung ist, deshalb wird, wenn ein kritischer Thread endet, der darunter liegende/fortgesetzte Thread (sofern vorhanden) automatisch unkritisch sein. Somit ist es nicht notwendig,
+Critical "Off"kurz vor dem Ende eines Threads auszuführen.Wenn Critical vom Auto-Execute-Thread nicht verwendet wird, sind alle Threads zunächst unkritisch (obwohl die Einstellungen von Thread Interrupt weiterhin gelten). Wenn hingegen der Auto-Execute-Thread Critical einschaltet, aber nie ausschaltet, ist jeder neu gestartete Thread (z.B. Hotkey, benutzerdefinierter Menüpunkt oder zeitgesteuerte Subroutine) zunächst kritisch.
Thread NoTimers ist quasi dasselbe wie Critical, verhindert aber nur, dass Timer den aktuellen Thread unterbrechen.
Meldungsüberprüfintervall
-Die Angabe einer positiven Zahl im ersten Parameter (z.B.
+Critical 30) schaltet Critical ein und ändert die Mindestanzahl der zu wartenden Millisekunden zwischen den Überprüfungen der internen Meldungswarteschlange. Wenn keine Zahl angegeben ist, wird bei eingeschaltetem Critical standardmäßig 16 ms und bei ausgeschaltetem Critical standardmäßig 5 ms gewartet. Die Erhöhung des Intervalls verzögert das Eintreffen von Meldungen/Ereignissen, so dass der aktuelle Thread mehr Zeit für seine Beendigung hat. Dies verringert das Risiko, dass einzelne OnMessage-Rückrufe und GUI-Ereignisse aufgrund von "Thread wird bereits ausgeführt" verloren gehen. Wartende Funktionen wie Sleep und WinWait werden Meldungen unabhängig von dieser Einstellung überprüfen (um das umgehen, können Sie z.B.DllCall("Sleep", "UInt", 500)nutzen).Die Angabe einer positiven Zahl im ersten Parameter (z.B.
Critical 30) schaltet Critical ein und ändert die Anzahl der Millisekunden, die mindestens zwischen den Überprüfungen der internen Meldungswarteschlange gewartet werden muss. Wenn keine Zahl angegeben ist, wird bei eingeschaltetem Critical standardmäßig 16 ms und bei ausgeschaltetem Critical standardmäßig 5 ms gewartet. Die Erhöhung des Intervalls verzögert das Eintreffen von Meldungen/Ereignissen, so dass der aktuelle Thread mehr Zeit für seine Beendigung hat. Dies verringert das Risiko, dass einzelne OnMessage-Rückrufe und GUI-Ereignisse aufgrund von "Thread wird bereits ausgeführt" verloren gehen. Wartende Funktionen wie Sleep und WinWait werden Meldungen unabhängig von dieser Einstellung überprüfen (um das zu umgehen, können Sie z.B.DllCall("Sleep", "UInt", 500)verwenden).Diese Einstellung hat Einfluss auf Folgendes:
- Präemptive Meldungsüberprüfungen, die vor der Ausführung jeder Codezeile stattfinden können. @@ -68,7 +68,7 @@
Beispiele
#space:: ; Hotkey: WIN+LEERTASTE. { Critical - ToolTip "Neue Threads werden erst gestartet, wenn dieser Tooltip verschwindet." + ToolTip "Neue Threads werden erst gestartet, wenn dieser Tooltip verschwunden ist." Sleep 3000 ToolTip ; Tooltip ausschalten. return ; Die Rückkehr aus einer Hotkey-Funktion beendet den Thread. Jeder darunter liegende Thread, der fortgesetzt werden soll, ist per Definition unkritisch. diff --git a/target/docs/lib/DateAdd.htm b/target/docs/lib/DateAdd.htm index 7775ea49..58d2dee1 100644 --- a/target/docs/lib/DateAdd.htm +++ b/target/docs/lib/DateAdd.htm @@ -2,7 +2,7 @@DateAdd - Syntax & Verwendung | AutoHotkey v2 - + @@ -14,7 +14,7 @@DateAdd
-Addiert oder subtrahiert Zeit von einem Datum-Zeit-Wert.
+Erhöht oder verringert einen Datum-Zeit-Wert um eine bestimmte Zeitmenge.
Ergebnis := DateAdd(DatumZeit, Zeit, ZeitEinheit)Parameter
@@ -29,23 +29,23 @@Parameter
- Zeit
- -
Die Zeitmenge, die addiert werden soll (Integer oder Floating-Point-Zahlen). Mit einer negativen Zahl kann eine Subtraktion durchgeführt werden.
+Die zu addierende Zeitmenge, als Integer oder Floating-Point-Zahl. Mit einer negativen Zahl kann subtrahiert werden.
- ZeitEinheit
Typ: Zeichenkette
-Das Einheitszeichen des Zeit-Parameters. ZeitEinheit kann eine der folgenden Zeichenketten sein (oder jeweils nur erste Buchstabe davon): Seconds, Minutes, Hours oder Days.
Die Bedeutung des Zeit-Parameters. ZeitEinheit kann eine der folgenden Zeichenketten sein (oder jeweils nur der erste Buchstabe davon): Seconds, Minutes, Hours oder Days.
Rückgabewert
Typ: Zeichenkette
-Diese Funktion gibt eine Zeichenkette von Ziffern im YYYYMMDDHH24MISS-Format zurück. Diese Zeichenkette sollte nicht als Zahl behandelt werden (man sollte keine mathematischen Operationen an ihr durchführen oder sie numerisch vergleichen).
+Diese Funktion gibt eine Zeichenkette von Ziffern im YYYYMMDDHH24MISS-Format zurück. Diese Zeichenkette sollte nicht als Zahl behandelt werden, d.h. es sollten keine Berechnungen oder numerischen Vergleiche mit ihr durchgeführt werden.
Bemerkungen
Die interne Variable A_Now enthält die aktuelle Ortszeit im YYYYMMDDHH24MISS-Format.
-Mit DateDiff kann die Zeitspanne zwischen zwei Zeitstempeln berechnet werden.
+Mit DateDiff kann die Zeitdifferenz zwischen zwei Zeitstempeln berechnet werden.
Enthält DatumZeit einen ungültigen Zeitstempel oder ein Jahr älter als 1601, wird ein ValueError ausgelöst.
Siehe auch
@@ -53,9 +53,9 @@Siehe auch
Beispiele
-diff --git a/target/docs/lib/DateDiff.htm b/target/docs/lib/DateDiff.htm index 3a7e4590..e3c6003a 100644 --- a/target/docs/lib/DateDiff.htm +++ b/target/docs/lib/DateDiff.htm @@ -20,31 +20,30 @@Addiert das heutige Datum um 31 Tage.
+Addiert 31 Tage auf das heutige Datum und meldet das Ergebnis in lesbarer Form.
-Zukunft := DateAdd(A_Now, 31, "days") +Zukunft := DateAdd(A_Now, 31, "d") MsgBox FormatTime(Zukunft)
DateDiff
Parameter
-
-
- DatumZeit1 -
- DatumZeit2 +
- DatumZeit1, DatumZeit2
-
Typ: Zeichenkette
Zeitstempel im YYYYMMDDHH24MISS-Format.
-Wenn DatumZeit1 älter als DatumZeit2 ist, wird das Ergebnis eine negative Zahl sein.
-Wenn einer der beiden Parameter eine leere Zeichenkette ist, wird die aktuelle Ortszeit (A_Now) verwendet.
+Wenn einer der Parameter eine leere Zeichenkette ist, wird die aktuelle Ortszeit (A_Now) verwendet.
- ZeitEinheit
-
Typ: Zeichenkette
-Das Einheitszeichen der Zeitdifferenz. ZeitEinheit kann eine der folgenden Zeichenketten sein (oder jeweils nur erste Buchstabe davon): Seconds, Minutes, Hours oder Days.
+Die Einheit, in der die Differenz gemessen werden soll. ZeitEinheit kann eine der folgenden Zeichenketten sein (oder jeweils nur der erste Buchstabe davon): Seconds, Minutes, Hours oder Days.
Rückgabewert
Typ: Integer
-Diese Funktion gibt die Differenz zwischen zwei Zeitstempeln in der angegebenen ZeitEinheit zurück. Das Ergebnis wird immer auf die nächste ganze Zahl abgerundet. Wenn z.B. die tatsächliche Differenz zwischen zwei Zeitstempeln 1.999 Tage beträgt, wäre das gemeldete Ergebnis 1 Tag. Um eine höhere Genauigkeit zu erzielen, geben Sie für ZeitEinheit das Wort Seconds an und teilen Sie das Ergebnis durch 60.0, 3600.0 oder 86400.0.
+Diese Funktion gibt die Differenz zwischen zwei Zeitstempeln in der angegebenen ZeitEinheit zurück. Wenn DatumZeit1 älter als DatumZeit2 ist, wird eine negative Zahl zurückgegeben.
+Das Ergebnis wird immer auf die nächste ganze Zahl abgerundet. Wenn z.B. die tatsächliche Differenz zwischen zwei Zeitstempeln 1.999 Tage beträgt, wäre das gemeldete Ergebnis 1 Tag. Um eine höhere Genauigkeit zu erzielen, geben Sie für ZeitEinheit das Wort Seconds an und teilen Sie das Ergebnis durch 60.0, 3600.0 oder 86400.0.
Bemerkungen
Die interne Variable A_Now enthält die aktuelle Ortszeit im YYYYMMDDHH24MISS-Format.
Um die verstrichene Zeit zwischen zwei Ereignissen genau zu bestimmen, verwenden Sie die A_TickCount-Methode, weil sie eine Präzision im Millisekundenbereich ermöglicht.
-Mit DateAdd können Sekunden, Minuten, Stunden oder Tage mit einem Zeitstempel addiert oder subtrahiert werden (mit einer negativen Zahl wird eine Subtraktion erreicht).
+Mit DateAdd können Sekunden, Minuten, Stunden oder Tage zu einem Zeitstempel addiert oder davon subtrahiert werden (mit einer negativen Zahl wird eine Subtraktion erreicht).
Enthält DatumZeit einen ungültigen Zeitstempel oder ein Jahr älter als 1601, wird ein ValueError ausgelöst.
Siehe auch
@@ -54,7 +53,7 @@Beispiele
Berechnet die Anzahl der Tage zwischen zwei Zeitstempeln und meldet das Ergebnis.
var1 := "20050126" var2 := "20040126" -MsgBox DateDiff(var1, var2, "days") ; Das Ergebnis ist 366, weil 2004 ein Schaltjahr ist. +MsgBox DateDiff(var1, var2, "d") ; Das Ergebnis ist 366, weil 2004 ein Schaltjahr ist.
Rückgabewert
Bemerkungen
Wenn DetectHiddenText nicht verwendet wird, ist die Einstellung standardmäßig 1 (true).
-"Versteckter Text" ist ein Begriff, der sich auf nicht sichtbare Steuerelemente eines Fensters bezieht. Ihr Text gilt daher als "versteckt". Das Ausschalten von DetectHiddenText ist zum Beispiel nützlich, um den Unterschied zwischen den verschiedenen Bereichen eines Multi-Bereich- oder Multi-Tab-Fensters festzustellen. Mit dem internen Tool "Window Spy" kann ermittelt werden, welcher Text des gerade aktiven Fensters versteckt ist. Alle internen Funktionen, die einen FensterText-Parameter akzeptieren, sind davon betroffen, einschließlich WinActivate, WinActive, WinWait und WinExist.
+"Versteckter Text" ist ein Begriff, der sich auf nicht sichtbare Steuerelemente eines Fensters bezieht. Ihr Text gilt daher als "versteckt". Das Ausschalten von DetectHiddenText ist zum Beispiel nützlich, um den Unterschied zwischen den verschiedenen Bereichen eines Multi-Bereich- oder Multi-Tab-Fensters festzustellen. Mit dem internen Tool "Window Spy" kann ermittelt werden, welcher Text des gerade aktiven Fensters versteckt ist. Alle internen Funktionen, die einen FensterText-Parameter akzeptieren, sind von dieser Einstellung betroffen, einschließlich WinActivate, WinActive, WinWait und WinExist.
Die interne Variable A_DetectHiddenText enthält die aktuelle Einstellung (1 oder 0).
-Jeder neu gestartete Thread (z.B. ein Hotkey, ein benutzerdefinierter Menüpunkt oder eine zeitgesteuerte Subroutine) verwendet vorerst die Standardeinstellung der Funktion. Um diese zu ändern, nutzen Sie die Funktion während der Startphase des Skripts.
+Jeder neu gestartete Thread (z.B. ein Hotkey, ein benutzerdefinierter Menüpunkt oder eine zeitgesteuerte Subroutine) verwendet zunächst die Standardeinstellung der Funktion. Diese Standardeinstellung kann geändert werden, indem die Funktion während der Startphase des Skripts verwendet wird.
Siehe auch
Beispiele
diff --git a/target/docs/lib/DetectHiddenWindows.htm b/target/docs/lib/DetectHiddenWindows.htm index 620d9fd2..28ad4893 100644 --- a/target/docs/lib/DetectHiddenWindows.htm +++ b/target/docs/lib/DetectHiddenWindows.htm @@ -36,23 +36,23 @@Rückgabewert
Bemerkungen
Wenn DetectHiddenWindows nicht verwendet wird, ist die Einstellung standardmäßig 0 (false).
Das Einschalten von DetectHiddenWindows kann dazu führen, dass der gesuchte Titel oder Text ungewollt mit einem versteckten Systemfenster übereinstimmt. Daher sollten die meisten Skripte diese Einstellung ausgeschaltet lassen. Allerdings kann diese Einstellung nützlich sein, wenn Sie direkt mit versteckten Fenstern arbeiten möchten, ohne diese vorher mit WinShow sichtbar zu machen.
-Alle fensterspezifischen Funktionen, außer WinShow, sind von dieser Einstellung betroffen, einschließlich WinActivate, WinActive, WinWait und WinExist. Beachten Sie, dass WinShow immer in der Lage ist, ein verstecktes Fenster sichtbar zu machen, unabhängig von dieser Einstellung.
+Alle fensterspezifischen Funktionen außer WinShow sind von dieser Einstellung betroffen, einschließlich WinActivate, WinActive, WinWait und WinExist. Beachten Sie, dass WinShow immer in der Lage ist, ein verstecktes Fenster sichtbar zu machen, unabhängig von dieser Einstellung.
Das Einschalten von DetectHiddenWindows ist in den folgenden Fällen nicht erforderlich:
- Wenn eine reine HWND-Nummer verwendet wird, wie bei
WinShow(A_ScriptHwnd).
- - Wenn ein Objekt mit einer Hwnd-Eigenschaft (z.B. Gui) verwendet wird, wie bei
WinMoveTop(MeineGui).
+ - Wenn ein Objekt mit einer Hwnd-Eigenschaft (z.B. ein Gui) verwendet wird, wie bei
WinMoveTop(MeineGui). - Wenn auf ein Steuerelement oder untergeordnetes Fenster via ahk_id oder als zuletzt gefundene Fenster zugegriffen wird.
- Wenn auf ein GUI-Fenster via +LastFound-Option zugegriffen wird.
Getarnte Fenster werden auch als versteckt betrachtet. Getarnte Fenster wurden mit Windows 8 eingeführt und sind Fenster auf einem inaktiven virtuellen Desktop oder UWP-Anwendungen, die zur Verbesserung der Performanz, genauer gesagt zur Verringerung ihres Speicherverbrauchs, unterbrochen wurden. In Windows 10 werden die Prozesse solcher Fenster im Task-Manager mit einem grünen Blatt angezeigt. Solche Fenster sind für den Benutzer trotz des WS_VISIBLE-Styles verborgen.
Die interne Variable A_DetectHiddenWindows enthält die aktuelle Einstellung (1 oder 0).
-Jeder neu gestartete Thread (z.B. ein Hotkey, ein benutzerdefinierter Menüpunkt oder eine zeitgesteuerte Subroutine) verwendet vorerst die Standardeinstellung der Funktion. Um diese zu ändern, nutzen Sie die Funktion während der Startphase des Skripts.
+Jeder neu gestartete Thread (z.B. ein Hotkey, ein benutzerdefinierter Menüpunkt oder eine zeitgesteuerte Subroutine) verwendet zunächst die Standardeinstellung der Funktion. Diese Standardeinstellung kann geändert werden, indem die Funktion während der Startphase des Skripts verwendet wird.
Siehe auch
Beispiele
diff --git a/target/docs/lib/DirCopy.htm b/target/docs/lib/DirCopy.htm index 64f998b6..a00cd545 100644 --- a/target/docs/lib/DirCopy.htm +++ b/target/docs/lib/DirCopy.htm @@ -46,11 +46,11 @@Schaltet die Erkennung von versteckten Fenstern ein.
-DetectHiddenWindows True
+DetectHiddenWindows true
Parameter
Fehlerbehandlung
Es wird eine Ausnahme ausgelöst, wenn ein Fehler auftritt.
-Enthält das Quellverzeichnis eine gespeicherte Webseite, bestehend aus Seitenname.htm und dem dazugehörigen Verzeichnis Seitenname_Dateien, kann es vorkommen, dass eine Ausnahme ausgelöst wird, obwohl das Kopieren erfolgreich war.
+Enthält das Quellverzeichnis eine gespeicherte Webseite, die aus Seitenname.htm und dem zugehörigen Verzeichnis Seitenname_Dateien besteht, kann eine Ausnahme ausgelöst werden, auch wenn der Kopiervorgang erfolgreich war.
Bemerkungen
Wenn die Verzeichnisstruktur des Ziels nicht vorhanden ist, wird sie automatisch erstellt, falls möglich.
-Da die Operation in der Lage ist, einen Ordner mit all seinen Unterordnern und Dateien rekursiv zu kopieren, ist das Ergebnis beim Kopieren eines Ordners auf ein Ziel irgendwo in sich selbst nicht definiert. Um dieses Problem zu umgehen, kopieren Sie den Ordner zuerst irgendwo anders hin und verwenden Sie danach DirMove, um den kopierten Ordner auf die gewünschte Position zu verschieben.
+Da die Operation in der Lage ist, einen Ordner mit all seinen Unterordnern und Dateien rekursiv zu kopieren, ist das Ergebnis beim Kopieren eines Ordners auf ein Ziel irgendwo in sich selbst nicht definiert. Um das zu umgehen, kopieren Sie den Ordner zuerst irgendwo anders hin und verwenden Sie danach DirMove, um den kopierten Ordner an den gewünschten Ort zu verschieben.
DirCopy kopiert nur einen einzigen Ordner. Um stattdessen den kompletten Inhalt eines Ordners (all seine Dateien und Unterordner) zu kopieren, verwenden Sie das Beispiel ganz am Ende der FileCopy-Seite.
Siehe auch
DirMove, FileCopy, FileMove, FileDelete, Datei-Schleife, DirSelect, SplitPath
@@ -62,11 +62,11 @@Beispiele
diff --git a/target/docs/lib/DirCreate.htm b/target/docs/lib/DirCreate.htm index cfde2a2a..954e50ad 100644 --- a/target/docs/lib/DirCreate.htm +++ b/target/docs/lib/DirCreate.htm @@ -33,7 +33,7 @@Fordert den Benutzer auf, einen Ordner zu kopieren.
-QuelleOrdner := DirSelect(, 3, "Wähle den Ordner, der kopiert werden soll") +
QuelleOrdner := DirSelect(, 3, "Wählen Sie den Ordner aus, der kopiert werden soll") if QuelleOrdner = "" return ; Andernfalls fortfahren. -ZielOrdner := DirSelect(, 3, "Wähle den Ordner, der die Kopie des Ordners enthalten soll.") +ZielOrdner := DirSelect(, 3, "Wählen Sie den Ordner aus, der die Kopie des Ordners enthalten soll.") if ZielOrdner = "" return ; Andernfalls fortfahren. @@ -77,7 +77,7 @@Beispiele
try DirCopy QuelleOrdner, ZielOrdner "\" QuelleOrdnerName catch - MsgBox "Der Ordner konnte nicht kopiert werden, weil ein Ordner mit demselben Namen in '" ZielOrdner "' vermutlich bereits existiert." + MsgBox "Der Ordner konnte nicht kopiert werden, vermutlich weil in '" ZielOrdner "' bereits ein Ordner mit diesem Namen existiert." returnFehlerbehandlung
A_LastError wird auf das Ergebnis der Systemfunktion GetLastError() gesetzt.
Bemerkungen
-Diese Funktion erstellt auch alle übergeordneten Verzeichnisse, die in VerzName vorkommen, falls sie noch nicht vorhanden sind.
+Diese Funktion erstellt auch alle in VerzName angegebenen Elternverzeichnisse, falls diese noch nicht existieren.
Siehe auch
Beispiele
diff --git a/target/docs/lib/DirDelete.htm b/target/docs/lib/DirDelete.htm index 839004d0..067cd313 100644 --- a/target/docs/lib/DirDelete.htm +++ b/target/docs/lib/DirDelete.htm @@ -49,7 +49,7 @@Beispiele
diff --git a/target/docs/lib/DirExist.htm b/target/docs/lib/DirExist.htm index ef41dc6e..703e987f 100644 --- a/target/docs/lib/DirExist.htm +++ b/target/docs/lib/DirExist.htm @@ -30,7 +30,7 @@Entfernt das Verzeichnis, einschließlich dessen Dateien und Unterverzeichnisse.
-DirDelete "C:\Download-Temp", 1
+DirDelete "C:\Download-Temp", true
Parameter
Rückgabewert
Typ: Zeichenkette
-Diese Funktion gibt die Attribute des ersten passenden Ordners zurück. Diese Zeichenkette ist eine Teilmenge von
+RASHDOC, wovon jeder Buchstabe die folgende Bedeutung hat:Diese Funktion gibt die Attribute des ersten gefundenen Ordners zurück. Diese Zeichenkette ist eine Teilmenge von
RASHDOC, wobei jeder Buchstabe die folgende Bedeutung hat:- R = READONLY (schreibgeschützt)
- A = ARCHIVE (archiviert) @@ -40,13 +40,13 @@
- O = OFFLINE
- C = COMPRESSED (komprimiert)
Rückgabewert
Da diese Funktion nur prüft, ob ein Ordner existiert, ist "D" immer im Rückgabewert enthalten. Wenn keine Ordner gefunden werden konnten, wird eine leere Zeichenkette zurückgegeben.
+Da diese Funktion nur prüft, ob ein Ordner existiert, ist "D" immer im Rückgabewert enthalten. Wenn kein Ordner gefunden wurde, wird eine leere Zeichenkette zurückgegeben.
Bemerkungen
-Beachten Sie, dass eine Suche wie
+DirExist("OrdnerMitDateienUndUnterordner\*")nur anzeigt, ob ein Ordner existiert. Wenn Sie prüfen wollen, ob Dateien und Ordner existieren, verwenden Sie stattdessen FileExist.Beachten Sie, dass eine Suche wie
DirExist("OrdnerMitDateienUndUnterordner\*")nur anzeigt, ob ein Ordner existiert. Um zu prüfen, ob Dateien und Ordner existieren, verwenden Sie stattdessen FileExist.Im Gegensatz zu FileGetAttrib unterstützt DirExist Platzhaltermuster und gibt immer einen nicht-leeren Wert zurück, wenn ein passender Ordner gefunden wurde.
Da eine leere Zeichenkette als "falsch" angesehen wird, kann der Rückgabewert der Funktion immer als boolescher Scheinwert verwendet werden. Zum Beispiel ist die Anweisung
-if DirExist("C:\MeinOrdner")wahr, wenn der Ordner existiert, andernfalls falsch.Da DateiMuster auch Platzhalterzeichen enthalten kann, ist DirExist möglicherweise nicht geeignet, um zu prüfen, ob ein Ordnerpfad gültig ist, der in Verbindung mit einer anderen Funktion oder einem anderen Programm verwendet werden soll. Zum Beispiel kann
+DirExist("Program*")Attribute zurückgeben, auch dann, wenn "Program*" kein gültiger Dateiname ist. Für solche Fälle wird FileGetAttrib empfohlen.Da DateiMuster auch Platzhalterzeichen enthalten kann, ist DirExist möglicherweise nicht geeignet, um zu prüfen, ob ein Ordnerpfad gültig ist, der in Verbindung mit einer anderen Funktion oder einem anderen Programm verwendet werden soll. Zum Beispiel kann
DirExist("Program*")Attribute zurückgeben, auch dann, wenn "Program*" kein gültiger Ordnername ist. Für solche Fälle wird FileGetAttrib empfohlen.Siehe auch
FileExist, FileGetAttrib, Datei-Schleife
@@ -65,7 +65,7 @@Beispiele
Fehlerbehandlung
Es wird ein OSError ausgelöst, wenn eine Meldung nicht an das Steuerelement gesendet werden konnte.
Bemerkungen
-Um die korrekte Funktionalität zu gewährleisten, setzt diese Funktion zudem den Eingabefokus auf das Steuerelement.
-Um die Zuverlässigkeit zu verbessern, wird nach jeder Benutzung dieser Funktion automatisch eine Verzögerung durchgeführt. Diese Verzögerung kann via SetControlDelay oder durch direktes Ändern des A_ControlDelay-Wertes geändert werden. Schauen Sie sich die Bemerkungen zu SetControlDelay an, um mehr zu erfahren.
+Damit diese Funktion korrekt funktioniert, wird das Steuerelement außerdem fokussiert.
+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.
Fenstertitel und -texte sind Groß-/Kleinschreibung-sensitiv. Versteckte Fenster werden nur erkannt, wenn DetectHiddenWindows eingeschaltet ist.
Siehe auch
diff --git a/target/docs/lib/ControlSetEnabled.htm b/target/docs/lib/ControlSetEnabled.htm index 775e1b29..228a2449 100644 --- a/target/docs/lib/ControlSetEnabled.htm +++ b/target/docs/lib/ControlSetEnabled.htm @@ -24,7 +24,7 @@Parameter
Zeigt ein Mitteilungsfenster an, wenn ein Ordner nicht existiert.
+Zeigt ein Mitteilungsfenster an, wenn ein Ordner nicht existiert.
if not DirExist("C:\Temp")
MsgBox "Der Zielordner existiert nicht."
Fehlerbehandlung
Es wird eine Ausnahme ausgelöst, wenn ein Fehler auftritt.
Bemerkungen
-DirMove verschiebt nur einen einzigen Ordner auf eine neue Position. Um stattdessen den kompletten Inhalt eines Ordners (all seine Dateien und Unterordner) zu verschieben, verwenden Sie das Beispiel ganz am Ende der FileMove-Seite.
+DirMove verschiebt nur einen einzelnen Ordner an einen neuen Ort. Um stattdessen den kompletten Inhalt eines Ordners (all seine Dateien und Unterordner) zu verschieben, verwenden Sie das Beispiel ganz am Ende der FileMove-Seite.
Wenn sich Quelle und Ziel auf unterschiedlichen Datenträgern oder UNC-Pfaden befinden, wird Kopieren/Löschen statt Verschieben durchgeführt.
Siehe auch
DirCopy, FileCopy, FileMove, FileDelete, Datei-Schleife, DirSelect, SplitPath
diff --git a/target/docs/lib/DirSelect.htm b/target/docs/lib/DirSelect.htm index ae2aacc8..76d77087 100644 --- a/target/docs/lib/DirSelect.htm +++ b/target/docs/lib/DirSelect.htm @@ -23,8 +23,8 @@Parameter
Typ: Zeichenkette
-Wenn leer oder weggelassen, beginnt die Navigation standardmäßig im Benutzerordner "Eigene Dokumente" (oder eventuell Arbeitsplatz/Computer). Ein CLSID-Ordner wie "::{20D04FE0-3AEA-1069-A2D8-08002B30309D}" (Arbeitsplatz/Computer) kann angegeben werden, um die Navigation in einem bestimmten Spezialordner zu beginnen.
Andernfalls wird dieser Parameter hauptsächlich verwendet, um ein Sternchen einzufügen und direkt danach den absoluten Pfadnamen des Laufwerks oder Ordners anzugeben, der vorab ausgewählt sein soll. Zum Beispiel würde "*C:\" bewirken, dass das C-Laufwerk zu Beginn ausgewählt ist. "*C:\Mein Ordner" würde bewirken, dass genau dieser Ordner zu Beginn ausgewählt ist.
Wenn leer oder weggelassen, beginnt die Navigation standardmäßig im Ordner "Dokumente" des Benutzers oder evtl. "Dieser PC" (ehemals Arbeitsplatz oder Computer). Ein CLSID-Ordner wie "::{20D04FE0-3AEA-1069-A2D8-08002B30309D}" (Dieser PC) kann angegeben werden, um die Navigation in einem bestimmten Spezialordner zu beginnen.
Andernfalls wird dieser Parameter hauptsächlich verwendet, um ein Sternchen einzufügen und direkt danach den absoluten Pfadnamen des Laufwerks oder Ordners anzugeben, der vorab ausgewählt sein soll. Zum Beispiel würde "*C:\" vorab das C-Laufwerk auswählen und "*C:\Mein Ordner" vorab diesen konkreten Ordner auswählen.
Das Sternchen bewirkt, dass der Benutzer vom Startordner aus nach oben (näher zum Stammverzeichnis) navigieren darf. Ohne Sternchen wäre der Benutzer gezwungen, einen Ordner innerhalb von StartOrdner (oder StartOrdner selbst) auszuwählen. Das Weglassen des Sternchens hat z.B. den Vorteil, dass StartOrdner zu Beginn im aufgeklappten Zustand angezeigt wird, was dem Benutzer das Anklicken des ersten Pluszeichens erspart.
Wenn das Sternchen vorhanden ist, kann die Aufwärtsnavigation optional auf einen anderen Ordner als den Desktop beschränkt werden. Stellen Sie dem Sternchen einfach den absoluten Pfad des obersten Ordners voran, gefolgt von genau einem Leer- oder Tabulatorzeichen. Zum Beispiel würde "C:\Mein Ordner *C:\Mein Ordner\Projekte" dem Benutzer verbieten, höher als C:\Mein Ordner zu navigieren (allerdings wäre C:\Mein Ordner\Projekte vorab ausgewählt).
Parameter
Typ: Integer
Wenn weggelassen, wird standardmäßig 1 verwendet. Andernfalls geben Sie eine der folgenden Zahlen an:
-0: Keine der folgenden Optionen ist wirksam (in Windows 2000 könnte dennoch die Schaltfläche "Neuer Ordner" angezeigt werden).
+0: Keine der folgenden Optionen ist wirksam.
1: Zeigt eine Schaltfläche an, die der Benutzer zum Erstellen neuer Ordner verwenden kann.
Addieren Sie 2 zur obigen Zahl, um ein Eingabefeld anzuzeigen, das der Benutzer zum Eintragen eines Ordnernamens verwenden kann. Wenn dieser Parameter z.B. 3 ist, wird sowohl ein Eingabefeld als auch die Schaltfläche "Neuer Ordner" angezeigt.
-Addieren Sie 4 zur obigen Zahl, um die Eigenschaft BIF_NEWDIALOGSTYLE zu entfernen. Dadurch wird sichergestellt, dass DirSelect auch in einer vorinstallierten Umgebung wie WinPE oder BartPE funktioniert, aber verhindert, dass die Schaltfläche "Neuer Ordner" vorhanden ist.
-Wenn der Benutzer den Namen eines ungültigen Ordners in das Eingabefeld einträgt, wird AusgewählterOrdner auf einen Wert gesetzt, der nicht den eingetragenen Text, sondern den im Navigationsbereich ausgewählten Ordner repräsentiert.
+Addieren Sie 4 zur obigen Zahl, um die Eigenschaft BIF_NEWDIALOGSTYLE zu entfernen. Dadurch wird sichergestellt, dass DirSelect auch in einer vorinstallierten Umgebung wie WinPE oder BartPE funktioniert, verhindert aber, dass die Schaltfläche "Neuer Ordner" angezeigt wird.
+Wenn der Benutzer einen ungültigen Ordnernamen in das Eingabefeld einträgt, wird AusgewählterOrdner auf den im Navigationsbereich ausgewählten Ordner gesetzt, nicht auf den vom Benutzer eingetragenen Text.
Parameter
Rückgabewert
Typ: Zeichenkette
-Diese Funktion gibt den vollständigen Pfad und Namen des vom Benutzer ausgewählten Ordners zurück. Wenn der Benutzer das Dialogfenster abbricht (bzw. keinen Ordner auswählen möchte), wird eine leere Zeichenkette zurückgegeben. Wenn der Benutzer ein Root-Verzeichnis auswählt (z.B. C:\), endet der Rückgabewert mit einem umgekehrten Schrägstrich. Falls das unerwünscht ist, kann der Schrägstrich wie folgt entfernt werden:
+Diese Funktion gibt den vollständigen Pfad und Namen des vom Benutzer ausgewählten Ordners zurück. Wenn der Benutzer das Dialogfenster abbricht (also keinen Ordner auswählen möchte), wird eine leere Zeichenkette zurückgegeben. Wenn der Benutzer ein Stammverzeichnis auswählt (z.B. C:\), endet der Rückgabewert mit einem umgekehrten Schrägstrich. Falls das unerwünscht ist, kann der Schrägstrich wie folgt entfernt werden:
Ordner := RegExReplace(DirSelect(), "\\$") ; Entfernt den umgekehrten Schrägstrich am Ende, falls vorhanden.-
Es wird auch eine leere Zeichenkette zurückgegeben, wenn das Betriebssystem sich weigert, das Dialogfenster anzuzeigen, aber dieses Problem tritt nur sehr selten auf.
+Eine leere Zeichenkette wird auch zurückgegeben, wenn das Betriebssystem sich weigert, das Dialogfenster anzuzeigen, was jedoch sehr selten vorkommt.
Bemerkungen
Ein typisches Ordnerauswahlfenster sieht wie folgt aus:
@@ -73,8 +73,8 @@Beispiele
Ein CLSID-Beispiel. Ermöglicht dem Benutzer die Auswahl eines Ordners im "Dieser PC"-Verzeichnis.
-AusgewählterOrdner := DirSelect("::{20D04FE0-3AEA-1069-A2D8-08002B30309D}") ; Dieser PC.
+Ein CLSID-Beispiel. Ermöglicht dem Benutzer die Auswahl eines Ordners in Dieser PC (ehemals Arbeitsplatz oder Computer).
+AusgewählterOrdner := DirSelect("::{20D04FE0-3AEA-1069-A2D8-08002B30309D}")
Parameter
Typ: Zeichenkette oder Integer
-Der Name einer DLL- oder EXE-Datei, gefolgt von einem umgekehrten Schrägstrich und dem Namen der Funktion. Zum Beispiel: "MeineDLL\MeineFunktion" (wenn die Dateiendung weggelassen wird, wird standardmäßig ".dll" verwendet). Wenn kein absoluter Pfad angegeben ist, wird DllDatei in einem der Pfade aus der PATH-Umgebungsvariable oder im A_WorkingDir-Verzeichnis vermutet. Beachten Sie, dass DllCall einen Pfad mit umgekehrten Schrägstrichen (\) erwartet. Schrägstriche (/) werden nicht unterstützt.
DllDatei kann weggelassen werden, wenn eine Funktion aus den Systemdateien User32.dll, Kernel32.dll, ComCtl32.dll oder Gdi32.dll aufgerufen wird. Zum Beispiel liefert "User32\IsWindowVisible" das gleiche Ergebnis wie "IsWindowVisible".
Wenn keine Funktion unter dem angegebenen Namen gefunden werden kann, wird automatisch ein W (Unicode) angefügt. Zum Beispiel ist "MessageBox" das gleiche wie "MessageBoxW".
Wenn die DLL wiederholt aufgerufen wird, ist es ratsam, sie vorher zu laden, um die Performanz dramatisch zu erhöhen.
-Dieser Parameter kann auch ein reiner Integer sein, der als Adresse einer Funktion zum Aufrufen interpretiert wird. Quellen solcher Adressen sind unter anderem COM und CallbackCreate.
+Der Name einer DLL- oder EXE-Datei, gefolgt von einem umgekehrten Schrägstrich und dem Namen der Funktion. Zum Beispiel: "MeineDLL\MeineFunktion" (wenn die Dateiendung weggelassen wird, wird standardmäßig ".dll" verwendet). Wenn kein absoluter Pfad angegeben ist, wird DllDatei in einem der Pfade aus der PATH-Umgebungsvariable oder im A_WorkingDir-Verzeichnis vermutet. Beachten Sie, dass DllCall einen Pfad mit umgekehrten Schrägstrichen (\) erwartet. Nach rechts gerichtete Schrägstriche (/) werden nicht unterstützt.
DllDatei kann weggelassen werden, wenn eine Funktion aus den Systemdateien User32.dll, Kernel32.dll, ComCtl32.dll oder Gdi32.dll aufgerufen wird. Zum Beispiel liefert "User32\IsWindowVisible" dasselbe Ergebnis wie "IsWindowVisible".
Wenn unter dem angegebenen Namen keine Funktion gefunden wird, wird automatisch ein W (Unicode) angefügt. Zum Beispiel ist "MessageBox" dasselbe wie "MessageBoxW".
Wenn die DLL wiederholt aufgerufen wird, ist es ratsam, sie vorher zu laden, um die Performanz drastisch zu erhöhen.
+Dieser Parameter kann auch ein reiner Integer sein, der als Adresse einer Funktion zum Aufrufen interpretiert wird. Quellen für solche Adressen sind u.a. COM und CallbackCreate.
Wenn dieser Parameter ein Objekt ist, wird der Wert der Ptr-Eigenschaft des Objekts verwendet. Wenn diese Eigenschaft nicht existiert, wird ein PropertyError ausgelöst.
Parameter
Typ: Zeichenkette
-Das Wort Cdecl wird normalerweise weggelassen, da die meisten Funktionen die Standardaufrufkonvention anstelle der C-Aufrufkonvention verwenden (Funktionen wie wsprintf, die eine unterschiedliche Anzahl von Argumenten akzeptieren, sind eine Ausnahme). Beachten Sie, dass die meisten objektorientierten C++-Funktionen die thiscall-Konvention nutzen, die in AutoHotkey nicht unterstützt wird.
+Das Wort Cdecl wird normalerweise weggelassen, da die meisten Funktionen die Standardaufrufkonvention anstelle der C-Aufrufkonvention verwenden (Funktionen wie wsprintf, die eine unterschiedliche Anzahl von Argumenten akzeptieren, sind eine Ausnahme). Beachten Sie, dass die meisten objektorientierten C++-Funktionen die nicht unterstützte thiscall-Konvention verwenden.
Das Wort Cdecl muss vor dem Rückgabetyp (falls vorhanden) stehen. Trennen Sie alle Wörter jeweils durch ein Leer- oder Tabulatorzeichen. Zum Beispiel: "Cdecl Str".
Da eine separate C-Aufrufkonvention im 64-Bit-Code nicht existiert, ist die Angabe von Cdecl in 64-Bit-Versionen von AutoHotkey wirkungslos.
+Da es im 64-Bit-Code keine separate C-Aufrufkonvention gibt, hat die Angabe von Cdecl in 64-Bit-Builds von AutoHotkey keine Wirkung.
RückgabeTyp: Wenn die Funktion einen vorzeichenfähigen 32-Bit-Integer (Int), BOOL oder nichts zurückgibt, kann RückgabeTyp weggelassen werden. Andernfalls geben Sie einen der Argumenttypen aus der Typentabelle unten an. Das Sternchen-Suffix wird ebenfalls unterstützt.
Parameter
Rückgabewert
Typ: Zeichenkette oder Integer
-DllCall gibt den Rückgabewert von Funktion zurück. Wenn Funktion vom Typ ist, der keinen Wert zurückgibt, ist das Ergebnis ein undefinierter Wert des angegebenen Rückgabetyps (standardmäßig Integer).
+DllCall gibt den Rückgabewert von Funktion zurück. Wenn Funktion keinen Rückgabewert hat, ist das Ergebnis ein undefinierter Wert des angegebenen Rückgabetyps (standardmäßig Integer).
Typen von Argumenten und Rückgabewerten
| Str |
- Eine Zeichenkette wie z.B. Wenn die Funktion so ausgelegt ist, dass sie eine Zeichenkette länger als der Eingabewert des Parameters speichert (oder wenn der Parameter nur für die Ausgabe vorgesehen ist), wird folgende Vorgehensweise empfohlen: Erstellen Sie ein Buffer-Objekt, nutzen Sie den Ptr-Typ, um ihn zu übergeben, und nutzen Sie StrGet, um die Zeichenkette nach Abschluss der Funktion abzurufen, wie im wsprintf-Beispiel gezeigt. -Andernfalls stellen Sie sicher, dass die Variable vor dem Aufruf der Funktion groß genug ist. Um das zu erreichen, können Sie Eine Zeichenkette wie z.B. Wenn die Funktion eine Zeichenkette zurückgibt, die länger ist als der Eingabewert des Parameters (oder wenn der Parameter nur für die Ausgabe bestimmt ist), wird die folgende Vorgehensweise empfohlen: 1) Erstellen Sie ein Buffer, 2) übergeben Sie es mit dem Ptr-Typ, und 3) rufen Sie die Zeichenkette nach Abschluss der Funktion mit StrGet ab, wie im wsprintf-Beispiel gezeigt. +Andernfalls sollten Sie vor dem Funktionsaufruf sicherstellen, dass die Variable groß genug ist. Rufen Sie hierfür Ein Str-Argument darf kein Ausdruck sein, der nach der Auswertung eine Zahl ergibt (z.B. Der selten verwendete Str*-Argumenttyp übergibt die Adresse einer temporären Variable, die die Adresse der Zeichenkette enthält. Wenn die Funktion eine neue Adresse in die temporäre Variable schreibt, wird die neue Zeichenkette in die Variable des Skripts kopiert, sofern eine VarRef übergeben wurde. Dies kann in Verbindung mit Funktionen verwendet werden, die so etwas wie "TCHAR **" oder "LPTSTR *" erwarten. Wenn die Funktion jedoch Speicher reserviert und erwartet, dass der Aufrufer ihn freigibt (z.B. durch Aufruf von CoTaskMemFree), muss stattdessen der Der selten verwendete Str*-Argumenttyp übergibt die Adresse einer temporären Variable, die die Adresse der Zeichenkette enthält. Wenn die Funktion eine neue Adresse in die temporäre Variable schreibt, wird die neue Zeichenkette in die Variable des Skripts kopiert, sofern eine VarRef übergeben wurde. Dies kann für Funktionen verwendet werden, die so etwas wie "TCHAR **" oder "LPTSTR *" erwarten. Wenn die Funktion jedoch Speicher reserviert und erwartet, dass der Aufrufer ihn wieder freigibt (z.B. durch Aufruf von CoTaskMemFree), muss stattdessen der Hinweis: Wenn Sie eine Zeichenkette an eine Funktion übergeben, müssen Sie darauf achten, welchen Typ von Zeichenkette die Funktion erwartet. |
|
| WStr | -Da AutoHotkey standardmäßig UTF-16 verwendet, ist WStr (Wide Character String) äquivalent zu Str. | +Da AutoHotkey nativ UTF-16 verwendet, ist WStr (Wide Character String) äquivalent zu Str. |
| AStr |
- AStr bewirkt, dass der Eingabewert automatisch in ANSI umgewandelt wird. Da der für diese Konvertierung verwendete temporäre Speicher nur groß genug für die konvertierte Eingabezeichenkette ist, werden alle Werte, die die Funktion in diese Zeichenkette schreibt, verworfen. Das folgende Beispiel zeigt, wie eine ANSI-Zeichenkette als Ausgabeparameter abgerufen werden kann: +AStr bewirkt, dass der Eingabewert automatisch in ANSI umgewandelt wird. Da der für diese Umwandlung verwendete temporäre Speicher nur groß genug für die umgewandelte Eingabezeichenkette ist, werden alle Werte, die die Funktion in diese Zeichenkette schreibt, verworfen. Um eine ANSI-Zeichenkette als Ausgabeparameter zu empfangen, gehen Sie wie folgt vor: buf := Buffer(Länge) ; Temporären Pufferspeicher reservieren.
-DllCall("Function", "ptr", buf) ; Pufferspeicher an Function übergeben.
+DllCall("Funktion", "ptr", buf) ; Pufferspeicher an Funktion übergeben.
str := StrGet(buf, "cp0") ; ANSI-Zeichenkette aus dem Pufferspeicher abrufen.
- Der selten verwendete AStr*-Argumenttyp wird ebenfalls unterstützt und verhält sich ähnlich wie der Str*-Typ, außer dass jede neue Zeichenkette im ANSI-Format in das native Format (UTF-16) umgewandelt wird. +Der selten verwendete AStr*-Argumenttyp wird ebenfalls unterstützt und verhält sich ähnlich wie der Str*-Typ, außer dass jede neue Zeichenkette von ANSI in das native Format (UTF-16) umgewandelt wird. Weitere Informationen und äquivalente Win32-Typen finden Sie unter Binärkompatibilität. |
|
| Ptr | -Ein pointergroßer Integer, der je nach AutoHotkey-Version (32- oder 64-Bit) einem Int oder Int64 entspricht. Ptr sollte für Pointer verwendet werden, die auf Arrays oder Strukturen verweisen (wie RECT* oder LPPOINT), und für fast alle Handles (wie HWND, HBRUSH oder HBITMAP). Wenn der Parameter ein Pointer ist, der auf einen einzelnen numerischen Wert verweist, wie z.B. LPDWORD oder int*, sollte grundsätzlich das *- oder P-Suffix anstelle von "Ptr" verwendet werden. -Übergibt man ein Objekt an einen Ptr-Parameter, wird der Wert der Übergibt man ein Objekt an einen Ptr*-Parameter, wird der Wert der | Ein pointergroßer Integer, äquivalent zu Int oder Int64, je nachdem, ob die EXE-Datei, die das Skript ausführt, 32-Bit oder 64-Bit ist. Ptr sollte für Pointer verwendet werden, die auf Arrays oder Strukturen verweisen (wie RECT* oder LPPOINT), und für fast alle Handles (wie HWND, HBRUSH oder HBITMAP). Wenn der Parameter ein Pointer ist, der auf einen einzelnen numerischen Wert verweist, wie z.B. LPDWORD oder int*, sollte grundsätzlich das *- oder P-Suffix anstelle von "Ptr" verwendet werden. +Wenn ein Objekt an einen Ptr-Parameter übergeben wird, wird der Wert der Wenn ein Objekt an einen Ptr*-Parameter übergeben wird, wird der Wert der Ptr kann auch mit dem *- oder P-Suffix verwendet werden; es sollte mit Funktionen verwendet werden, die einen Pointer via LPVOID* oder ähnliches zurückgeben. UPtr ist auch gültig, ist aber nur vorzeichenlos in 32-Bit-Builds, da AutoHotkey keine vorzeichenlosen 64-Bit-Integer unterstützt. Hinweis: Um ein NULL-Handle oder -Pointer zu übergeben, verwenden Sie den Integer 0. |
@@ -121,10 +121,10 @@
| * oder P (Suffix) |
- Fügen Sie ein Sternchen (optional mit einem Leerzeichen davor) an einen der obigen Typen an, um nicht den Wert selbst, sondern die Adresse des Arguments zu übergeben (die aufgerufene Funktion muss dafür ausgelegt sein, so etwas zu akzeptieren). Der Wert eines solchen Arguments kann von der Funktion geändert werden, d.h. jedes Mal, wenn eine VarRef als Argument übergeben wird, wird der Inhalt der Variable nach Abschluss der Funktion aktualisiert. Zum Beispiel würde der folgende Aufruf den Inhalt von MeineVar an MeineFunktion via Adresse übergeben, aber auch den Inhalt von MeineVar aktualisieren, um alle Änderungen widerzuspiegeln, die MeineFunktion an MeineVar vorgenommen hat: In der Regel wird ein Sternchen verwendet, wenn eine Funktion einen Argument- oder Rückgabetyp hat, der mit "LP" beginnt. Das bekannteste Beispiel dafür ist LPDWORD (ein Pointer, der auf ein DWORD verweist). Da DWORD ein vorzeichenloser 32-Bit-Integer ist, können Sie "UInt*" oder "UIntP" für LPDWORD verwenden. Zeichenkettentypen wie LPTSTR, auf Strukturen verweisende Pointer wie LPRECT, oder Arrays sollten nicht mit einem Sternchen versehen werden; für solche Typen ist "Str" oder "Ptr" besser geeignet, je nachdem, ob eine Zeichenkette, Adresse oder Buffer übergeben wird. + | Fügen Sie ein Sternchen (optional mit einem Leerzeichen davor) an einen der obigen Typen an, um nicht den Wert selbst, sondern die Adresse des Arguments zu übergeben (die aufgerufene Funktion muss dafür ausgelegt sein, so etwas zu akzeptieren). Da der Wert eines solchen Arguments von der Funktion geändert werden kann, wird jedes Mal, wenn eine VarRef als Argument übergeben wird, der Inhalt der Variable nach Abschluss der Funktion aktualisiert. Zum Beispiel würde der folgende Aufruf den Inhalt von MeineVar an MeineFunktion via Adresse übergeben, aber auch den Inhalt von MeineVar aktualisieren, um alle Änderungen widerzuspiegeln, die MeineFunktion an MeineVar vorgenommen hat: In der Regel wird ein Sternchen verwendet, wenn eine Funktion einen Argument- oder Rückgabetyp hat, der mit "LP" beginnt. Das bekannteste Beispiel dafür ist LPDWORD (ein Pointer, der auf ein DWORD verweist). Da DWORD ein vorzeichenloser 32-Bit-Integer ist, können Sie "UInt*" oder "UIntP" für LPDWORD verwenden. Das Sternchen sollte nicht für Zeichenkettentypen wie LPTSTR, auf Strukturen verweisende Pointer wie LPRECT, oder Arrays verwendet werden; für solche Typen ist "Str" oder "Ptr" besser geeignet, je nachdem, ob eine Zeichenkette, eine Adresse oder ein Buffer übergeben wird. Hinweis: "Char*" ist nicht dasselbe wie "Str", weil "Char*" die Adresse einer 8-Bit-Zahl übergibt, während "Str" die Adresse einer Zeichenkette übergibt, die je nach AutoHotkey-Version 16-Bit (Unicode) oder 8-Bit (für "AStr") ist. Ähnlich verhält es sich mit "UInt*": Da dieser Typ die Adresse einer 32-Bit-Zahl übergibt, ist er nicht für Funktionen geeignet, die ein Array mit Werten oder eine Struktur größer als 32 Bit erwarten. -Da Variablen in AutoHotkey keinen festen Typ haben, bezieht sich eine an die Funktion übergebene Adresse auf einen temporären Speicher, nicht auf die Variable des Aufrufers. +Da Variablen in AutoHotkey keinen festen Typ haben, verweist eine an die Funktion übergebene Adresse auf einen temporären Speicher, nicht auf die Variable des Aufrufers. |
| HRESULT |
- Ein 32-Bit-Integer. Dieser Typ wird grundsätzlich im Zusammenhang mit COM-Funktionen verwendet und ist nur als Rückgabetyp ohne Präfix oder Suffix gültig. Fehlerwerte (wie durch das FAILED-Makro definiert) werden nie zurückgegeben; stattdessen wird ein OSError ausgelöst. Daher ist der Rückgabewert ein Erfolgscode im Bereich von 0 bis 2147483647. -HRESULT ist der Standard-Rückgabetyp von ComCall. +Ein 32-Bit-Integer. Dies wird grundsätzlich für COM-Funktionen verwendet und ist nur als Rückgabetyp ohne Präfix oder Suffix gültig. Fehlerwerte (wie durch das FAILED-Makro definiert) werden nie zurückgegeben; stattdessen wird ein OSError ausgelöst. Daher ist der Rückgabewert ein Erfolgscode im Bereich von 0 bis 2147483647. +HRESULT ist der reguläre Rückgabetyp für ComCall. |
Fehlerbehandlung
Exception.Extra enthält den hexadezimalen Fehlercode.Exception.Extra enthält den Ausnahmecode. 0xC0000005 bedeutet z.B. "Zugriffsverletzung". In solchen Fällen wird der Thread unterbrochen (wenn try nicht verwendet wird), während alle Sternchenvariablen weiter aktualisiert werden. Eine fatale Ausnahme ist zum Beispiel die Dereferenzierung eines ungültigen Pointers wie NULL (0). Da eine Cdecl-Funktion niemals den im nächsten Absatz beschriebenen Fehler erzeugt, löst die Funktion stattdessen eine Ausnahme aus, wenn ihr zu wenig Argumente übergeben werden.Exception.Extra enthält die Anzahl der Bytes, um wie viel die Argumentenliste inkorrekt war. Wenn dieser Wert positiv ist, wurden zu viele Argumente (oder zu lange Argumente) übergeben, oder der Aufruf benötigt CDecl. Wenn dieser Wert negativ ist, wurden zu wenig Argumente übergeben. Dieser Fehler sollte behoben werden, um einen zuverlässigen Betrieb der Funktion zu gewährleisten. Dieser Fehler könnte auch ein Indikator dafür sein, dass eine Ausnahme aufgetreten ist. Beachten Sie, dass 64-Bit-Versionen von AutoHotkey aufgrund der x64-Aufrufkonvention nicht in der Lage sind, diesen Fehler auszulösen.Exception.Extra enthält die Anzahl der Bytes, um wie viel die Argumentenliste inkorrekt war. Wenn es positiv ist, wurden zu viele Argumente (oder zu lange Argumente) übergeben, oder der Aufruf benötigt CDecl. Wenn es negativ ist, wurden zu wenig Argumente übergeben. Dieser Fehler sollte behoben werden, um einen zuverlässigen Betrieb der Funktion zu gewährleisten. Dieser Fehler könnte auch ein Indikator dafür sein, dass eine Ausnahme aufgetreten ist. Beachten Sie, dass 64-Bit-Builds von AutoHotkey aufgrund der x64-Aufrufkonvention nicht in der Lage sind, diesen Fehler auszulösen.