ListView (GUI) - Syntax & Verwendung

Die ListView ist eines der umfangreichsten Steuerelemente, das vom Betriebssystem zur Verfügung gestellt wird. Eine ListView (auf Deutsch: Listenansicht) wird häufig verwendet, um eine Tabelle in Form von Zeilen und Spalten darzustellen. Das wohl bekannteste Beispiel dafür ist die detaillierte Auflistung von Dateien und Ordnern im Explorer.

Auch wenn es recht umfangreich erscheinen mag, sind die grundlegenden Features einer ListView relativ einfach zu bedienen. Die Syntax zum Erstellen einer ListView ist:

Das folgende Beispiel ist ein lauffähiges Skript, das alle Dateien im Ordner "Eigene Dateien" des Benutzers in einer ListView auflistet:

Optionen und Styles für den Optionen-Parameter

AltSubmit: Teilt dem Skript mehr ListView-Ereignisse als normal mit. Mit anderen Worten, das g-Label wird häufiger gestartet. Weitere Informationen finden Sie unter ListView-Benachrichtigungen.

Background: Geben Sie das Wort Background an, unmittelbar gefolgt von einem Farbnamen (siehe Farbentabelle) oder RGB-Wert (mit oder ohne 0x-Präfix). Beispiele: BackgroundSilver, BackgroundFFDD99. Wenn diese Option nicht vorhanden ist, verwendet die ListView als Hintergrundfarbe standardmäßig die Farbe, die im letzten Parameter von Gui Color definiert ist (wenn keine definiert ist, dann die Standardhintergrundfarbe des Systems). Mit BackgroundDefault kann die Standardhintergrundfarbe des Systems gesetzt werden (in der Regel weiß). Zum Beispiel kann die Standardfarbe einer ListView via GuiControl, +BackgroundDefault, MeineListView wiederhergestellt werden.

C: Textfarbe. Geben Sie den Buchstaben C an, unmittelbar gefolgt von einem Farbnamen (siehe Farbentabelle) oder RGB-Wert (mit oder ohne 0x-Präfix). Beispiele: cRed, cFF2211, c0xFF2211, cDefault.

Checked: Stellt eine CheckBox auf der linken Seite jeder Zeile bereit. Geben Sie beim Hinzufügen einer Zeile das Wort Check in den Optionen an, um die CheckBox vorerst im abgehakten Zustand anzuzeigen. Der Benutzer kann die CheckBox anklicken oder die Leertaste drücken, um ein Häkchen zu setzen oder zu entfernen.

Count: Geben Sie das Wort Count an, unmittelbar gefolgt von der Anzahl der Zeilen, die die ListView letztendlich enthalten soll. Dies ist kein Limit: Nach Erreichen dieser Anzahl können weiterhin neue Zeilen hinzugefügt werden. Stattdessen dient diese Option eher als Hinweis, dass das Steuerelement den Speicher nur einmal reservieren soll und nicht jedes Mal, wenn eine neue Zeile hinzugefügt wird, was die Performanz beim Hinzufügen neuer Zeilen (und bis zu einem gewissen Grad auch beim Sortieren) deutlich verbessert. Um die Performanz noch weiter zu verbessern, verwenden Sie GuiControl, -Redraw, MeineListView, bevor Sie eine große Anzahl von Zeilen hinzufügen. Verwenden Sie anschließend GuiControl, +Redraw, MeineListView, um die Neuzeichnung wieder zu aktivieren (wodurch auch das Steuerelement neu gezeichnet wird).

Grid: Zeigt horizontale und vertikale Linien an, um die Grenzen zwischen den Zeilen und Spalten zu verdeutlichen.

Hdr: Geben Sie -Hdr (minus Hdr) an, um die Kopfzeile (Spaltenüberschriften) zu verstecken. Um sie später wieder sichtbar zu machen, verwenden Sie GuiControl, +Hdr, MeineListView.

LV: Geben Sie die Zeichenkette LV an, unmittelbar gefolgt von der Zahl eines erweiterten ListView-Styles. Diese Styles sind etwas völlig anderes als die generischen erweiterten Styles. Zum Beispiel bewirkt -E0x200, dass der generische erweiterte Style WS_EX_CLIENTEDGE (Standardrahmen des Steuerelements) entfernt wird, während -LV0x20 den erweiterten ListView-Style LVS_EX_FULLROWSELECT entfernt.

LV0x10: Geben Sie -LV0x10 an, um den Benutzer daran zu hindern, die Spaltenüberschriften zwecks Neuanordnung nach links oder rechts zu verschieben. Normalerweise ist das in der Regel nicht notwendig, weil die physische Neuanordnung der Spalten keinen Einfluss auf die vom Skript gesehene Spaltenanordnung hat. Die erste Spalte wird aus Sicht des Skripts immer Spalte 1 sein, auch dann, wenn der Benutzer sie z.B. physisch ganz nach rechts verschoben hat.

LV0x20: Geben Sie -LV0x20 an, damit eine Zeile nur durch Anklicken des ersten Feldes ausgewählt werden kann (normalerweise kann sie durch Anklicken eines beliebigen Feldes ausgewählt werden). Diese Option hat den Vorteil, dass der Benutzer leichter ein Rechteck über mehrere Zeilen ziehen kann, um sie auszuwählen.

Multi: Geben Sie -Multi (minus Multi) an, um den Benutzer daran zu hindern, mehr als eine Zeile auszuwählen.

NoSortHdr: Verhindert, dass die Kopfzeile angeklickt werden kann. Die Spaltenüberschriften werden nicht mehr als normale Schaltflächen dargestellt, sondern bekommen ein flacheres Aussehen. Im Gegensatz zu den meisten anderen ListView-Styles kann dieser Style nicht mehr geändert werden, nachdem die ListView erstellt wurde.

NoSort: Verhindert die automatische Sortierung beim Anklicken einer Spaltenüberschrift. Die Spaltenüberschrift verhält sich jedoch weiterhin visuell wie eine Schaltfläche (es sei denn, die NoSortHdr-Option oben wurde angegeben). Außerdem erhält das g-Label weiterhin die ColClick-Benachrichtigung, die z.B. für eine benutzerdefinierte Sortierung verwendet werden kann.

ReadOnly: Geben Sie -ReadOnly (minus ReadOnly) an, um dem Benutzer das Editieren des Textes in der ersten Spalte jeder Zeile zu erlauben. Um eine Zeile zu editieren, wählen Sie sie aus und drücken Sie F2 (siehe WantF2-Option unten). Alternativ können Sie einmal auf eine Zeile klicken, um sie auszuwählen, mindestens eine halbe Sekunde warten und dann erneut auf dieselbe Zeile klicken, um sie zu editieren.

R: Höhe in Zeilen (beim Erstellen). Geben Sie den Buchstaben R an, unmittelbar gefolgt von der Anzahl der Zeilen, für die innerhalb des Steuerelements Platz geschaffen werden soll. Zum Beispiel bewirkt R10, dass das Steuerelement 10 Zeilen hoch gemacht wird. Wenn die ListView mit einem anderen Ansichtsmodus als Report erstellt wurde, wird die Höhe des Steuerelements so angepasst, dass Symbolzeilen anstelle von Textzeilen hineinpassen. Hinweis: Wenn Symbole zu den Zeilen einer ListView hinzugefügt werden, erhöht sich die Höhe jeder Zeile, wodurch diese Option ungenau wird.

Sort: Sortiert die Zeilen in alphabetischer Reihenfolge, basierend auf dem Inhalt der ersten Spalte.

WantF2: In [v1.0.44+] kann -WantF2 (minus WantF2) angegeben werden, um den Benutzer daran zu hindern, die aktuell fokussierte Zeile mit F2 zu editieren. Diese Einstellung wird ignoriert, es sei denn, -ReadOnly ist ebenfalls wirksam. Unabhängig von dieser Einstellung erhält das g-Label weiterhin F2-Benachrichtigungen.

(Namenlose numerische Styles): Andere Styles als die oben genannten werden nur selten verwendet und haben daher keine Namen. Eine vollständige Liste finden Sie unter ListView-Styles.

Ansichtsmodi

Eine ListView hat fünf Ansichtsmodi. Der am häufigsten verwendete Modus ist die Report-Ansicht (Standardeinstellung). Um eine andere Ansicht zu verwenden, fügen Sie den entsprechenden Namen in die Optionsliste ein. Die Ansicht kann auch geändert werden, nachdem das Steuerelement erstellt wurde, zum Beispiel: GuiControl, +IconSmall, MeineListView.

Icon: Große-Symbole-Ansicht. In dieser und allen anderen Ansichten außer Report sind nur die Texte der ersten Spalte sichtbar. Um Symbole in dieser Ansicht anzuzeigen, muss der ListView eine Große-Symbole-ImageList zugewiesen werden.

Tile: Große-Symbole-Ansicht, aber mit ergonomischen Unterschieden - z.B. wird der Text für jedes Element rechts vom Symbol angezeigt, nicht darunter. Checkboxen funktionieren nicht in dieser Ansicht. Außerdem wird der Versuch, diese Ansicht in Betriebssystemen älter als Windows XP anzuzeigen, ignoriert.

List: Kleine-Symbole-Ansicht im Listenformat, in der die Symbole in Spalten dargestellt werden. Die Anzahl der Spalten hängt von der Breite des Steuerelements und der Breite des breitesten darin enthaltenen Textelements ab.

Report: Wechselt zurück zur Report-Ansicht, was die Standardeinstellung für jede neue ListView ist. Zum Beispiel: GuiControl, +Report, MeineListView.

Interne ListView-Funktionen

Alle folgenden ListView-Funktionen arbeiten mit dem Standard-GUI-Fenster des aktuellen Threads (was z.B. mit Gui, 2:Default geändert werden kann). Wenn das Standardfenster nicht existiert oder keine ListView-Steuerelemente hat, geben alle Funktionen Null zurück, um das Problem zu kennzeichnen.

Wenn das Fenster mehr als ein ListView-Steuerelement hat, arbeiten die Funktionen standardmäßig mit dem zuletzt hinzugefügten. Um dies zu ändern, verwenden Sie Gui, ListView, ListViewName, wobei ListViewName entweder der Name der zugeordneten Variable, die ClassNN-Bezeichnung (wie vom internen Tool "Window Spy" angezeigt) oder in [v1.1.04+] die HWND-Nummer (eindeutige ID) der ListView ist. Einmal geändert, werden alle existierenden und zukünftigen Threads die angegebene ListView verwenden. [v1.1.23+]: A_DefaultListView enthält die aktuelle Einstellung.

Der auf dieser Seite verwendete Begriff "Zeilennummer" bezieht sich auf die aktuelle Position einer Zeile innerhalb der ListView. Die erste/oberste Zeile ist 1, die zweite 2 und so weiter. Nachdem eine Zeile hinzugefügt wurde, kann sich die Zeilennummer durch Sortieren, Löschen und Einfügen anderer Zeilen ändern. Daher ist es ratsam, LV_GetText() in einer Schleife zu verwenden, um bestimmte Zeilen anhand ihres Inhalts zu lokalisieren.

LV_Add

Parameter

Rückgabewert

Bei Erfolg gibt die Funktion die neue Zeilennummer zurück. Beachten Sie, dass diese Zeilennummer nicht unbedingt die letzte Zeile repräsentiert, wenn die ListView mit der Sort- oder SortDesc-Option erstellt wurde. Bei Misserfolg gibt sie 0 zurück.

LV_Insert

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion die angegebene Zeilennummer zurück. Bei Misserfolg gibt sie 0 zurück.

LV_Modify

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion die angegebene Zeilennummer zurück. Bei Misserfolg gibt sie 0 zurück. Wenn ZeileNummer 0 ist, um alle Zeilen zu ändern, gibt sie 1 zurück, wenn die Operation gänzlich erfolgreich war, oder 0, wenn irgendein Teil der Operation fehlgeschlagen ist.

Bemerkungen

Wenn nur die ersten zwei Parameter vorhanden sind, werden nur die Attribute der Zeile geändert, nicht der Inhalt ihrer Felder.

LV_Delete

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion 1 (true) zurück. Bei Misserfolg gibt sie 0 (false) zurück.

LV_ModifyCol

Ändert die Attribute und/oder den Text einer bestimmten Spalte und ihrer Überschrift.

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion 1 (true) zurück. Bei Misserfolg gibt sie 0 (false) zurück.

LV_InsertCol

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion die Positionsnummer der neuen Spalte zurück. Bei Misserfolg gibt sie 0 zurück.

Bemerkungen

Der Inhalt der neuen Spalte ist vorerst leer, es sei denn, es handelt sich um die erste Spalte, dann wird der Inhalt der alten ersten Spalte in die neue kopiert und anschließend leer gemacht.

LV_DeleteCol

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion 1 (true) zurück. Bei Misserfolg gibt sie 0 (false) zurück. In Betriebssystemen älter als Windows XP kann der Versuch, die originale erste Spalte zu löschen, fehlschlagen und 0 zurückgeben.

LV_GetCount

Parameter

Rückgabewert

Diese Funktion gibt die Anzahl der Zeilen oder Spalten im Steuerelement zurück. Der Wert wird immer sofort zurückgegeben, da das Steuerelement diese Zählungen zwischenspeichert.

Bemerkungen

Diese Funktion wird oft in der obersten Zeile einer Schleife verwendet - in diesem Fall wird die Funktion nur einmal aufgerufen (vor der ersten Wiederholung). Zum Beispiel:

Um die Spaltenbreiten einer ListView abzurufen, z.B. um sie in einer INI-Datei zwischenzuspeichern, gehen Sie wie folgt vor:

LV_GetNext

Gibt die Zeilennummer der nächsten ausgewählten, abgehakten oder fokussierten Zeile zurück.

Parameter

Rückgabewert

Diese Funktion gibt die Zeilennummer der nächsten ausgewählten, abgehakten oder fokussierten Zeile zurück. Wenn keine gefunden wird, gibt sie 0 zurück.

Bemerkungen

Das nächste Beispiel ist eine alternative Methode, um herauszufinden, ob eine bestimmte Zeilennummer abgehakt ist:

LV_GetText

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion 1 (true) zurück. Bei Misserfolg gibt sie 0 (false) zurück.

Bemerkungen

Die vom Skript gesehenen Spaltennummern bleiben unverändert, wenn der Benutzer die Spalten via Ziehen-und-Ablegen verschiebt. Zum Beispiel wäre die originale erste Spalte auch dann noch Nummer 1, wenn der Benutzer sie ganz nach rechts ziehen würde.

LV_SetImageList

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion die ImageList-ID zurück, die zuvor mit der ListView verknüpft war. Bei Misserfolg gibt sie 0 zurück. Eine nicht mehr verwendete ImageList sollte normalerweise mit IL_Destroy() zerstört werden.

Bemerkungen

Diese Funktion wird normalerweise aufgerufen, bevor Zeilen zur ListView hinzugefügt werden. Sie weist der ListView eine ImageList zu, die zur Darstellung von Symbolen in den Zeilen (und optional in den Spaltenüberschriften) verwendet wird.

Einer ListView können maximal zwei ImageLists zugewiesen werden - eine ImageList für kleine Symbole und/oder eine für große Symbole. Dies ist nützlich, wenn das Skript dem Benutzer die Möglichkeit bietet, zwischen der Kleine-Symbole- und Große-Symbole-Ansicht umzuschalten. Um der ListView mehr als eine ImageList zuzuweisen, rufen Sie LV_SetImageList() ein zweites Mal auf, mit der ImageList-ID der zweiten Liste. Eine ListView, die sowohl eine Kleine-Symbole- als auch Große-Symbole-ImageList verwendet, sollte sicherstellen, dass beide Listen die Symbole in der gleichen Reihenfolge enthalten. Der Grund dafür ist, dass dieselbe ID-Nummer verwendet wird, um sowohl auf die große als auch auf die kleine Version eines bestimmten Symbols zu verweisen.

Obwohl alle Ansichtsmodi außer Icon und Tile traditionell kleine Symbole anzeigen, kann dies überschrieben werden, indem eine Große-Symbole-ImageList an LV_SetImageList() übergeben und als zweiter Parameter 1 (kleines Symbol) angegeben wird. Dadurch wird auch die Höhe jeder Zeile in der ListView erhöht, um Platz für das große Symbol zu schaffen.

G-Label-Benachrichtigungen (Primär)

Es ist möglich, ein g-Label wie z.B. gMeineSubroutine in den Optionen des Steuerelements anzugeben. Dadurch wird jedes Mal, wenn der Benutzer eine Aktion im Steuerelement ausführt, das Label MeineSubroutine gestartet. Diese Subroutine kann die internen Variablen A_Gui und A_GuiControl verwenden, um zu ermitteln, welches Fenster und welche ListView für das Ereignis verantwortlich waren. Noch wichtiger ist, dass sie A_GuiEvent verwenden kann, die eine der folgenden Zeichenketten oder Buchstaben enthält (aus Kompatibilitätsgründen mit zukünftigen Versionen sollte ein Skript nicht davon ausgehen, dass das die einzig möglichen Werte sind):

DoubleClick: Der Benutzer hat im Steuerelement einen Doppelklick gemacht. Die interne Variable A_EventInfo enthält die Nummer der fokussierten Zeile. Mit LV_GetNext() kann stattdessen die Nummer der ersten ausgewählten Zeile abgerufen werden (die Nummer ist 0, wenn der Benutzer eine leere Fläche doppelt angeklickt hat).

R: Der Benutzer hat im Steuerelement einen doppelten Rechtsklick gemacht. Die interne Variable A_EventInfo enthält die Nummer der fokussierten Zeile.

ColClick: Der Benutzer hat eine Spaltenüberschrift angeklickt. Die Variable A_EventInfo enthält die Spaltennummer, die der Spalte ursprünglich bei ihrer Erstellung zugewiesen wurde, d.h. die Nummer spiegelt nicht das Ziehen und Ablegen von Spalten durch den Benutzer wider. Eine mögliche Reaktion auf einen Spaltenklick ist die Sortierung nach den Daten einer versteckten Spalte (mit einer Breite von 0), die in einem sortierfreundlichen Format vorliegen (z.B. ein Datum im YYYYMMDD-Format). Eine versteckte Spalte dieser Art spiegelt eine andere Spalte wider, die dieselben Daten in einem lesbaren Format (z.B. DD.MM.YY) anzeigt. Zum Beispiel könnte ein Skript die Spalte 3 via LV_ModifyCol(3, 0) verstecken und dann die automatische Sortierung in der sichtbaren Spalte 2 via LV_ModifyCol(2, "NoSort") deaktivieren. Anschließend würde das Skript als Reaktion auf die ColClick-Benachrichtigung für Spalte 2 die ListView nach den Daten der versteckten Spalte via LV_ModifyCol(3, "Sort") sortieren.

D: Der Benutzer hat begonnen, eine Zeile oder ein Symbol via Maus zu ziehen (derzeit wird das Ziehen von Zeilen oder Symbolen intern nicht unterstützt). Die interne Variable A_EventInfo enthält die Nummer der fokussierten Zeile. [v1.0.44+]: Diese Benachrichtigung tritt auch ohne AltSubmit auf.

d (kleines D): Dasselbe wie oben, außer dass beim Ziehen die rechte statt linke Maustaste verwendet wurde.

e (kleines E): Der Benutzer hat aufgehört, das erste Feld einer Zeile zu editieren (der Benutzer kann das Feld nur editieren, wenn -ReadOnly in den Optionen der ListView vorhanden ist). Die interne Variable A_EventInfo enthält die Nummer der Zeile.

G-Label-Benachrichtigungen (Sekundär)

Wenn das Wort AltSubmit in den Optionen der ListView vorhanden ist, wird das g-Label häufiger gestartet und A_GuiEvent kann die folgenden zusätzlichen Werte enthalten:

Normal: Der Benutzer hat eine Zeile mit der linken Maustaste angeklickt. Die interne Variable A_EventInfo enthält die Nummer der fokussierten Zeile.

RightClick: Der Benutzer hat eine Zeile mit der rechten Maustaste angeklickt. Die interne Variable A_EventInfo enthält die Nummer der fokussierten Zeile. In den meisten Fällen ist es ratsam, kein Kontextmenü als Reaktion auf dieses Ereignis anzuzeigen. Verwenden Sie stattdessen das GuiContextMenu-Label, da es auch die MENÜ-Taste erkennt. Zum Beispiel:

A: Eine Zeile wurde aktiviert, was standardmäßig durch einen Doppelklick geschieht. Die interne Variable A_EventInfo enthält die Nummer der Zeile.

E: Der Benutzer hat begonnen, das erste Feld einer Zeile zu editieren (der Benutzer kann das Feld nur editieren, wenn -ReadOnly in den Optionen der ListView vorhanden ist). Die interne Variable A_EventInfo enthält die Nummer der Zeile.

I: Der Zustand einer Zeile hat sich geändert, weil sie ausgewählt, abgewählt, abgehakt usw. wurde. Wenn der Benutzer eine neue Zeile auswählt, empfängt die ListView mindestens zwei solcher Benachrichtigungen: Eine für die Abwahl der vorherigen Zeile und eine für die Auswahl der neuen Zeile. [v1.0.44+]: Die interne Variable A_EventInfo enthält die Nummer der Zeile. [v1.0.46.10+]: ErrorLevel enthält beliebig viele der folgenden Buchstaben, die angeben, wie die Zeile geändert wurde: S (ausgewählt) oder s (abgewählt), und/oder F (fokussiert) oder f (defokussiert), und/oder C (Häkchen gesetzt) oder c (Häkchen entfernt). Zum Beispiel bedeutet SF, dass die Zeile ausgewählt und fokussiert wurde. Um festzustellen, ob ein bestimmter Buchstabe vorhanden ist, verwenden Sie eine parsende Schleife oder die GroßKleinSensitiv-Option von InStr(), z.B. InStr(ErrorLevel, "S", true). Hinweis: Aus Kompatibilitätsgründen mit zukünftigen Versionen sollte ein Skript nicht davon ausgehen, dass "SsFfCc" die einzig möglichen Buchstaben sind. Sie können auch Critical in die erste Zeile von g-Label einfügen, um sicherzustellen, dass alle "I"-Benachrichtigungen empfangen werden (andernfalls könnten einige von ihnen verloren gehen, wenn das Skript nicht mit ihnen Schritt halten kann).

K: Der Benutzer hat eine Taste gedrückt, während die ListView den Fokus hatte. A_EventInfo enthält den virtuellen Tastencode der Taste (eine Zahl zwischen 1 und 255). Dieser Code kann via GetKeyName() in einen Tastennamen oder in ein Zeichen übersetzt werden. Zum Beispiel Taste := GetKeyName(Format("vk{:x}", A_EventInfo)). Bei den meisten Tastaturbelegungen können die Tasten A bis Z via Chr(A_EventInfo) in das entsprechende Zeichen übersetzt werden. F2 wird unabhängig von WantF2 erfasst. Enter hingegen wird nicht erfasst; um es zu erfassen, verwenden Sie eine Standardschaltfläche, wie unten beschrieben.

M: Auswahlrechteck. Der Benutzer hat begonnen, ein Auswahlrechteck über mehrere Zeilen oder Symbole zu ziehen.

ImageLists

Eine ImageList (übersetzt Bildliste) ist eine Gruppe von gleich großen Symbolen, die im Speicher abgelegt sind. Zu Beginn ist jede ImageList leer. Das Skript ruft IL_Add() wiederholt auf, um Symbole zur Liste hinzuzufügen, wobei jedem Symbol eine fortlaufende Nummer zugewiesen wird, beginnend bei 1. Dies ist die Nummer, auf die sich das Skript bezieht, um ein bestimmtes Symbol in einer Zeile oder Spaltenüberschrift anzuzeigen. Das folgende Beispiel zeigt, wie Symbole in die Zeilen einer ListView eingefügt werden können:

IL_Create

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion die eindeutige ID der neuen ImageList zurück. Bei Misserfolg gibt sie 0 zurück.

IL_Add

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion die Indexnummer des neuen Symbols zurück (1 ist das erste Symbol, 2 das zweite usw.). Bei Misserfolg gibt sie 0 zurück.

IL_Destroy

Parameter

Rückgabewert

Bei Erfolg gibt diese Funktion 1 (true) zurück. Bei Misserfolg gibt sie 0 (false) zurück.

Bemerkungen

Es ist normalerweise nicht notwendig, ImageLists zu zerstören, da sie, wenn sie einmal mit einer ListView verbunden sind, automatisch zerstört werden, wenn die ListView oder ihr übergeordnetes Fenster zerstört wird. Wenn die ListView ihre ImageLists mit anderen ListViews teilt (indem sie 0x40 in ihren Optionen hat), sollte das Skript die ImageList explizit zerstören, nachdem es alle ListViews zerstört hat, die diese ImageList verwenden. Entsprechend sollte das Skript, wenn es eine der alten ImageLists mit einer neuen ersetzt, die alte explizit zerstören.

Bemerkungen

Der Befehl Gui Submit funktioniert nicht mit einem ListView-Steuerelement. Demzufolge kann die zugeordnete Variable der ListView (falls vorhanden) verwendet werden, um andere Daten zu speichern, ohne befürchten zu müssen, dass diese jemals überschrieben werden.

Nachdem eine Spalte sortiert wurde - z.B. durch Anklicken der Spaltenüberschrift oder Aufruf von LV_ModifyCol(1, "Sort") - erscheinen alle danach hinzugefügten Zeilen am Ende der Liste, anstatt die aktuelle Sortierreihenfolge zu berücksichtigen. Es sei denn, die Styles Sort und SortDesc werden verwendet, dann werden neue Zeilen an die korrekten Positionen verschoben.

Um einen Enter-Tastendruck in einer fokussierten ListView zu erfassen, verwenden Sie eine Standardschaltfläche (die bei Bedarf versteckt werden kann). Zum Beispiel:

Zusätzlich zur zeilenweisen Navigation mit der Tastatur kann der Benutzer auch eine inkrementelle Suche durchführen, indem er die ersten paar Zeichen eines in der ersten Spalte befindlichen Elements eingibt. Dadurch springt die Auswahl auf die nächst passende Zeile.

Obwohl ein beliebig langer Text in einem ListView-Feld gespeichert werden kann, werden nur die ersten 260 Zeichen angezeigt.

Obwohl die maximale Anzahl von Zeilen in einer ListView nur durch den verfügbaren Systemspeicher begrenzt ist, gibt es Möglichkeiten, die Performanz beim Hinzufügen von Zeilen erheblich zu verbessern. Einige davon finden Sie unter Count.

Es ist möglich, ein Bild als Hintergrund um eine ListView herum zu verwenden (also um die ListView damit einzurahmen). Um das zu realisieren, erstellen Sie ein Picture-Steuerelement nach der ListView und fügen Sie 0x4000000 (WS_CLIPSIBLINGS) in dessen Optionen ein.

Ein Skript kann mehr als eine ListView pro Fenster erstellen. Um mit einer anderen ListView zu arbeiten, siehe interne Funktionen.

Es ist ratsam, Spalten nicht direkt mit SendMessage einzufügen oder zu löschen. Der Grund dafür ist, dass das Programm für jede Spalte eine Sammlung von Sortiereinstellungen verwaltet und diese dann nicht mehr synchron wären. Verwenden Sie stattdessen die internen Spaltenfunktionen.

Mit GuiControl kann eine ListView z.B. größer/kleiner gemacht, versteckt oder mit einer anderen Schrift versehen werden.

Mit ControlGet List können Texte aus externen ListViews (die nicht zum Skript gehören) extrahiert werden.

Siehe auch

Beispiele

Das folgende Beispiel ist ein lauffähiges Skript, das umfangreicher ist als das obige Beispiel. Es zeigt die Dateien eines vom Benutzer ausgewählten Ordners an und weist jeder Datei je nach Typ das entsprechende Symbol zu. Der Benutzer kann eine Datei doppelt anklicken, um sie zu öffnen, oder eine oder mehrere Dateien rechtsklicken, um ein Kontextmenü anzuzeigen.

; Dem Benutzer erlauben, das Fenster zu maximieren oder dessen Größe zu ändern:
Gui +Resize

; Einige Schaltflächen erstellen:
Gui, Add, Button, Default gButtonOrdnerLaden, Ordner laden
Gui, Add, Button, x+20 gButtonLeeren, Liste leeren
Gui, Add, Button, x+20, Ansicht wechseln

; ListView und ihre Spalten via Gui Add erstellen:
Gui, Add, ListView, xm r20 w700 vMeineListView gMeineListView, Name|Ordner|Größe (KB)|Typ
LV_ModifyCol(3, "Integer")  ; Aus Sortierungsgründen die Spalte "Größe" als Integer kennzeichnen.

; Eine ImageList erstellen, damit die ListView einige Symbole anzeigen kann:
ImageListID1 := IL_Create(10)
ImageListID2 := IL_Create(10, 10, true)  ; Eine Liste von großen Symbolen, analog zu den kleinen.

; Die ImageLists mit der ListView verbinden, damit diese später die Symbole anzeigen kann:
LV_SetImageList(ImageListID1)
LV_SetImageList(ImageListID2)

; Ein Kontextmenü erstellen:
Menu, MeinKontextmenü, Add, Öffnen, KontextDateiÖffnen
Menu, MeinKontextmenü, Add, Eigenschaften, KontextEigenschaften
Menu, MeinKontextmenü, Add, Aus der ListView entfernen, KontextZeilenLöschen
Menu, MeinKontextmenü, Default, Öffnen  ; "Öffnen" in fetter Schrift darstellen, um zu kennzeichnen, dass ein Doppelklick dasselbe bewirkt.

; Das Fenster anzeigen und in den Leerlauf gehen. Das System wird das Skript
; jedes Mal benachrichtigen, wenn der Benutzer eine gültige Aktion ausführt:
Gui, Show
return


ButtonOrdnerLaden:
Gui +OwnDialogs  ; Den Benutzer zwingen, das folgende Dialogfenster zu schließen, bevor er das Hauptfenster nutzen kann.
FileSelectFolder, Ordner,, 3, Wählen Sie einen Ordner zum Einlesen aus:
if not Ordner  ; Der Benutzer hat das Dialogfenster abgebrochen.
    return

; Prüfen, ob das letzte Zeichen im Ordnernamen ein umgekehrter Schrägstrich ist,
; was bei Root-Verzeichnissen wie C:\ vorkommt. Trifft dies zu, entfernen, um doppelte Schrägstriche zu vermeiden.
LetztesZeichen := SubStr(Ordner, 0)
if (LetztesZeichen = "\")
    Ordner := SubStr(Ordner, 1, -1)  ; Schrägstrich am Ende entfernen.

; Erforderliche Puffergröße für die SHFILEINFO-Struktur berechnen.
sfi_größe := A_PtrSize + 8 + (A_IsUnicode ? 680 : 340)
VarSetCapacity(sfi, sfi_größe)

; Eine Liste von Dateinamen zusammenstellen und zur ListView hinzufügen:
GuiControl, -Redraw, MeineListView  ; Performanz verbessern durch Abschalten von Redraw beim Laden.
Loop %Ordner%\*.*
{
    DateiName := A_LoopFileFullPath  ; Muss für unten in eine beschreibbare Variable gespeichert werden.

    ; Eindeutige Endungs-ID erstellen, um Zeichen zu vermeiden, die in Variablennamen
    ; illegal sind, wie z.B. Bindestriche. Außerdem ist diese Methode performanter,
    ; weil das Auffinden eines Elements in einem Array keine Suchschleife erfordert.
    SplitPath, DateiName,,, DateiEndung  ; Endung der Datei ermitteln.
    if DateiEndung in EXE,ICO,ANI,CUR
    {
        EndungID := DateiEndung  ; Spezial-ID als Platzhalter.
        SymbolNummer := 0  ; Als nicht gefunden markieren, so dass diese Typen jeweils ein eindeutiges Symbol haben können.
    }
    else  ; Irgendeine andere Endung/Dateityp, also ihre eindeutige ID berechnen.
    {
        EndungID := 0  ; Initialisieren, um Endungen zu behandeln, die kürzer sind als andere.
        Loop 7     ; Endung auf 7 Zeichen limitieren, damit sie in einem 64-Bit-Wert passt.
        {
            EndungZeichen := SubStr(DateiEndung, A_Index, 1)
            if not EndungZeichen  ; Keine weiteren Zeichen.
                break
            ; Eindeutige ID ableiten, indem jedem Zeichen eine andere Bitposition zugewiesen wird:
            EndungID := EndungID | (Asc(EndungZeichen) << (8 * (A_Index - 1)))
        }
        ; Prüfen, ob diese Dateiendung bereits ein Symbol in den ImageLists hat.
        ; Ist dies der Fall, können mehrere Aufrufe verhindert und die Ladeperformanz
        ; deutlich verbessert werden, insbesondere bei Ordnern mit sehr vielen Dateien:
        SymbolNummer := SymbolArray%EndungID%
    }
    if not SymbolNummer  ; Es gibt noch kein Symbol für diese Endung, also laden.
    {
        ; Hochqualitatives kleines Symbol abrufen, das mit dieser Dateieendung verknüpft ist:
        if not DllCall("Shell32\SHGetFileInfo" . (A_IsUnicode ? "W":"A"), "Str", DateiName
            , "UInt", 0, "Ptr", &sfi, "UInt", sfi_größe, "UInt", 0x101)  ; 0x101 ist SHGFI_ICON+SHGFI_SMALLICON
            SymbolNummer := 9999999  ; Eine Nummer außerhalb des gültigen Bereichs setzen, um ein leeres Symbol anzuzeigen.
        else ; Symbol erfolgreich geladen.
        {
            ; hIcon-Element aus der Struktur extrahieren:
            hIcon := NumGet(sfi, 0)
            ; HICON direkt zur Kleine-Symbole- und Große-Symbole-Liste hinzufügen.
            ; Unten +1 verwenden, um den Rückgabeindex in 1-basiert umzuwandeln:
            SymbolNummer := DllCall("ImageList_ReplaceIcon", "Ptr", ImageListID1, "Int", -1, "Ptr", hIcon) + 1
            DllCall("ImageList_ReplaceIcon", "Ptr", ImageListID2, "Int", -1, "Ptr", hIcon)
            ; Da es in die ImageLists kopiert wurde, sollte das Original zerstört werden:
            DllCall("DestroyIcon", "Ptr", hIcon)
            ; Symbol zwischenspeichern, um Speicherbedarf zu reduzieren und Ladeperformanz zu verbessern:
            SymbolArray%EndungID% := SymbolNummer
        }
    }

    ; Neue Zeile hinzufügen und ihr die oben ermittelte Symbolnummer zuweisen:
    LV_Add("Icon" . SymbolNummer, A_LoopFileName, A_LoopFileDir, A_LoopFileSizeKB, DateiEndung)
}
GuiControl, +Redraw, MeineListView  ; Neuzeichnung reaktivieren (wurde oben deaktiviert).
LV_ModifyCol()  ; Breite jeder Spalte an ihren Inhalt anpassen.
LV_ModifyCol(3, 65) ; Die Spalte "Größe" etwas breiter machen, um die Kopfzeile sichtbar zu machen.
return


ButtonLeeren:
LV_Delete()  ; ListView leeren, aber den Symbol-Cache intakt lassen.
return

ButtonAnsichtWechseln:
if not SymbolAnsicht
    GuiControl, +Icon, MeineListView    ; Zur Symbolansicht wechseln.
else
    GuiControl, +Report, MeineListView  ; Zur Detailansicht zurückwechseln.
SymbolAnsicht := not SymbolAnsicht             ; Fürs nächste Mal umkehren.
return

MeineListView:
if (A_GuiEvent = "DoubleClick")  ; Es könnten noch andere Werte geprüft werden.
{
    LV_GetText(DateiName, A_EventInfo, 1) ; Text des ersten Feldes abrufen.
    LV_GetText(DateiVerz, A_EventInfo, 2)  ; Text des zweiten Feldes abrufen.
    Run %DateiVerz%\%DateiName%,, UseErrorLevel
    if ErrorLevel
        MsgBox "%DateiVerz%\%DateiName%" konnte nicht geöffnet werden.
}
return

GuiContextMenu:  ; Startet bei Rechtsklick oder Drücken der MENÜ-Taste.
if (A_GuiControl != "MeineListView")  ; Das Menü nur für Klicks innerhalb der ListView anzeigen.
    return
; Das Menü auf den Koordinaten A_GuiX und A_GuiY anzeigen. Diese Koordinaten
; sind auch dann korrekt, wenn der Benutzer die MENÜ-Taste drückt:
Menu, MeinKontextmenü, Show, %A_GuiX%, %A_GuiY%
return

KontextDateiÖffnen:  ; Der Benutzer hat "Öffnen" im Kontextmenü ausgewählt.
KontextEigenschaften:  ; Der Benutzer hat "Eigenschaften" im Kontextmenü ausgewählt.
; Nur mit der fokussierten Zeile arbeiten, nicht mit allen ausgewählten Zeilen:
FokussierteZeileNr := LV_GetNext(0, "F")  ; Die fokussierte Zeile finden.
if not FokussierteZeileNr  ; Keine Zeile fokussiert.
    return
LV_GetText(DateiName, FokussierteZeileNr, 1) ; Text des ersten Feldes abrufen.
LV_GetText(DateiVerz, FokussierteZeileNr, 2)  ; Text des zweiten Feldes abrufen.
if InStr(A_ThisMenuItem, "Öffnen")  ; Benutzer hat "Öffnen" im Kontextmenü ausgewählt.
    Run %DateiVerz%\%DateiName%,, UseErrorLevel
else  ; Der Benutzer hat "Eigenschaften" im Kontextmenü ausgewählt.
    Run Properties "%DateiVerz%\%DateiName%",, UseErrorLevel
if ErrorLevel
    MsgBox Gewünschte Aktion konnte nicht auf "%DateiVerz%\%DateiName%" angewendet werden.
return

KontextZeilenLöschen:  ; Der Benutzer hat "Leeren" im Kontextmenü ausgewählt.
ZeileNummer := 0  ; Die Suche bei der ersten Zeile beginnen.
Loop
{
    ; Da das Löschen einer Zeile die Zeilennummer aller anderen Zeilen darunter
    ; verringert, 1 subtrahieren, damit die Suche die zuvor gefundene Zeilennummer
    ; einbezieht (falls benachbarte Zeilen ausgewählt sind):
    ZeileNummer := LV_GetNext(ZeileNummer - 1)
    if not ZeileNummer  ; 0 zurückgegeben, also keine ausgewählten Zeilen mehr.
        break
    LV_Delete(ZeileNummer)  ; Die Zeile aus der ListView entfernen.
}
return

GuiSize:  ; ListView kleiner/größer machen, wenn Benutzer die Fenstergröße ändert.
if (A_EventInfo = 1)  ; Das Fenster wurde minimiert. Keine Aktion notwendig.
    return
; Andernfalls wurde das Fenster kleiner/größer gemacht oder maximiert. ListView-Größe entsprechend anpassen.
GuiControl, Move, MeineListView, % "W" . (A_GuiWidth - 20) . " H" . (A_GuiHeight - 40)
return

GuiClose:  ; Das Skript automatisch beenden, wenn das Fenster geschlossen wird:
ExitApp

ListView

Inhaltsverzeichnis

Einführung und einfaches Beispiel

Optionen und Styles für den Optionen-Parameter

Ansichtsmodi

Interne ListView-Funktionen

LV_Add

Parameter

Rückgabewert

LV_Insert

Parameter

Rückgabewert

LV_Modify

Parameter

Rückgabewert

Bemerkungen

LV_Delete

Parameter

Rückgabewert

LV_ModifyCol

Parameter

Rückgabewert

LV_InsertCol

Parameter

Rückgabewert

Bemerkungen

LV_DeleteCol

Parameter

Rückgabewert

LV_GetCount

Parameter

Rückgabewert

Bemerkungen

LV_GetNext

Parameter

Rückgabewert

Bemerkungen

LV_GetText

Parameter

Rückgabewert

Bemerkungen

LV_SetImageList

Parameter

Rückgabewert

Bemerkungen

G-Label-Benachrichtigungen (Primär)

G-Label-Benachrichtigungen (Sekundär)

ImageLists

IL_Create

Parameter

Rückgabewert

IL_Add

Parameter

Rückgabewert

IL_Destroy

Parameter

Rückgabewert

Bemerkungen

Bemerkungen

Siehe auch

Beispiele