NMLVCUSTOMDRAW-Struktur (commctrl.h)

  • Artikel

Enthält spezifische Informationen für einen NM_CUSTOMDRAW Benachrichtigungscode (Listenansicht), der von einem Listenansichtssteuerelement gesendet wird.

Syntax

typedef struct tagNMLVCUSTOMDRAW {
  NMCUSTOMDRAW nmcd;
  COLORREF     clrText;
  COLORREF     clrTextBk;
  int          iSubItem;
  DWORD        dwItemType;
  COLORREF     clrFace;
  int          iIconEffect;
  int          iIconPhase;
  int          iPartId;
  int          iStateId;
  RECT         rcText;
  UINT         uAlign;
} NMLVCUSTOMDRAW, *LPNMLVCUSTOMDRAW;

Member

nmcd

Typ: NMCUSTOMDRAW

NMCUSTOMDRAW-Struktur , die allgemeine benutzerdefinierte Zeichnungsinformationen enthält.

clrText

Typ: COLORREF

COLORREF-Wert , der die Farbe darstellt, die zum Anzeigen des Text-Vordergrunds im Listenansicht-Steuerelement verwendet wird.

clrTextBk

Typ: COLORREF

COLORREF-Wert , der die Farbe darstellt, die zum Anzeigen des Texthintergrunds im Listenansicht-Steuerelement verwendet wird. In Version 6.0 . wird dieser Member ignoriert, wenn das Hintergrundbild mit der LVM_SETBKIMAGE-Meldung festgelegt ist.

iSubItem

Typ: int

Version 4.71. Index des Unterelements, das gezeichnet wird. Wenn die Standard Element gezeichnet wird, ist dieses Element 0 (null).

dwItemType

Typ: DWORD

Version 6.0.   DWORD , das den Typ des zu zeichnenden Elements enthält. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
LVCDI_ITEM
 Ein Element soll gezeichnet werden.
LVCDI_GROUP
 Eine Gruppe soll gezeichnet werden.
LVCDI_ITEMSLIST
 Jedes Element muss gezeichnet werden.

clrFace

Typ: COLORREF

Version 6.0.COLORREF-Wert , der die Farbe darstellt, die zum Anzeigen des Gesichts eines Elements verwendet wird.

iIconEffect

Typ: int

Version 6.0.  Wert vom Typ int , der den Effekt angibt, der auf ein Symbol angewendet wird, z. B. Glow, Shadow oder Pulse.

iIconPhase

Typ: int

Version 6.0.  Der Wert vom Typ int , der die Phase eines Symbols angibt.

iPartId

Typ: int

Version 6.0.  Der Wert vom Typ int , der die ID des zu zeichnenden Teils eines Elements angibt.

iStateId

Typ: int

Version 6.0.  Der Wert vom Typ int , der die ID des Zustands eines zu zeichnenden Elements angibt.

rcText

Typ: RECT

Version 6.0.RECT , das das Rechteck angibt, in dem der Text gezeichnet werden soll.

uAlign

Typ: UINT

Version 6.0.UINT , das angibt, wie eine Gruppe ausgerichtet werden soll. Dieser Member kann einer der folgenden Werte sein.

Wert Bedeutung
LVGA_HEADER_CENTER
 Zentrierung der Gruppe.
LVGA_HEADER_LEFT
 Richten Sie die Gruppe auf der linken Seite aus.
LVGA_HEADER_RIGHT
 Richten Sie die Gruppe auf der rechten Seite aus.

Hinweise

Beachten Sie Comctl32.dll Version 6 nicht verteilbar, aber in Windows oder höher enthalten ist. Um Comctl32.dll Version 6 zu verwenden, geben Sie sie in einem Manifest an. Weitere Informationen zu Manifesten finden Sie unter Aktivieren von visuellen Formatvorlagen.
 

Anforderungen

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