ListView_GetItemState Makro (commctrl.h)

2024-10-24

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

Syntax

UINT ListView_GetItemState(
   HWND hwndLV,
   int  i,
   UINT mask
);

Parameter

hwndLV

Typ: HWND-

Ein Handle für das Listenansicht-Steuerelement.

i

Typ: int

Der Index des Listenansichtselements.

mask

Typ: UINT-

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

Wert	Bedeutung
LVIS_CUT	Das Element wird für einen Ausschneide- 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 Standardfokusrechteck umgeben ist. Obwohl mehrere Elemente ausgewählt werden können, kann nur ein Element den Fokus haben.
LVIS_SELECTED	Das Element ist ausgewählt. Die Darstellung eines ausgewählten Elements hängt davon ab, ob es den Fokus und auch die für die Auswahl verwendeten Systemfarben hat.
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

Typ: UINT-

Gibt den aktuellen Zustand für das angegebene Element zurück. Die einzigen gültigen Bits im Rückgabewert sind diejenigen, die den im mask Parameter festgelegten Bits entsprechen.

Bemerkungen

Die Statusinformationen eines Elements enthalten eine Reihe von Bitkennzeichnungen sowie Bildlistenindizes, die das Statusbild und das Überlagerungsbild des Elements angeben.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	commctrl.h

Siehe auch

ListView_SetItemState

Freigeben über