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

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