Freigeben über

ListView_GetItemState Makro (commctrl.h)

  • Artikel

Ruft den Status eines Listenansichtselements ab. Sie können dieses Makro verwenden oder die LVM_GETITEMSTATE Nachricht explizit senden.

Syntax

void ListView_GetItemState(
   hwndLV,
   i,
   mask
);

Parameter

hwndLV

Typ: HWND

Ein Handle für das Listenansicht-Steuerelement.

i

Typ: int

Der Index des Listenansichtselements.

mask

Typ: UINT

Die abzurufenden Zustandsinformationen. Dieser Parameter kann eine Kombination der folgenden Werte sein:

Wert Bedeutung
LVIS_CUT
 Das Element wird für einen Ausschneiden- und Einfügevorgang markiert.
LVIS_DROPHILITED
 Das Element wird als Drag-and-Drop-Ziel hervorgehoben.
LVIS_FOCUSED
 Das Element hat den Fokus, sodass es von einem Standard-Fokusrechteck umgeben ist. Obwohl mehrere Elemente ausgewählt werden können, kann nur ein Element den Fokus haben.
LVIS_SELECTED
 Das Element ist ausgewählt. Das Aussehen eines ausgewählten Elements hängt davon ab, ob es den Fokus hat, und auch von den für die Auswahl verwendeten Systemfarben.
LVIS_OVERLAYMASK
 Verwenden Sie diese Maske, um den Überlagerungsbildindex des Elements abzurufen.
LVIS_STATEIMAGEMASK
 Verwenden Sie diese Maske, um den Statusbildindex des Elements abzurufen.

Rückgabewert

Keine

Bemerkungen

Die Statusinformationen eines Elements umfassen eine Reihe von Bitflags sowie Bildlistenindizes, die das Zustandsbild und das Überlagerungsbild des Elements angeben.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile commctrl.h

Weitere Informationen

ListView_SetItemState