CWnd::OnDrawItem

Artikel
02/26/2013

Das Framework ruft diese Memberfunktion für den Besitzer eines Ownerdrawnschaltflächen-steuerelements, des Kombinationsfeldsteuerelements, Sie das Listenfeldsteuerelement oder des Menüs auf, wenn ein visueller Aspekt des Steuerelements oder des Menüs geändert hat.

afx_msg void OnDrawItem(
   int nIDCtl,
   LPDRAWITEMSTRUCT lpDrawItemStruct 
);

Parameter

nIDCtl
Enthält den Bezeichner des Steuerelements, das die WM_DRAWITEM Meldung gesendet.Wenn ein Menü die Nachricht gesendet hat, enthält nIDCtl 0.
lpDrawItemStruct
Gibt einen langen Zeiger auf eine DRAWITEMSTRUCT Datenstruktur, die Informationen über das Element enthält, die gezeichnet wird und dem Typ des Zeichnens erfordert an.

Hinweise

Der itemAction-Member der DRAWITEMSTRUCT-Struktur definiert den Zeichenvorgang, der ausgeführt werden soll.Die Daten in diesem Member ermöglichen dem Besitzer des Steuerelements, um zu bestimmen, welche Zeichnungsaktion erforderlich ist.

Bevor sie vom Verarbeitung dieser Meldung zurückgibt, sollte eine Anwendung sicherstellen, dass der Gerätekontext, der vom hDC-Member der DRAWITEMSTRUCT-Struktur identifiziert wird, dem Standardzustand wiederhergestellt wird.

Wenn der hwndItem-Member CButton, CMenu, CListBox oder CComboBox-Objekt gehört, wird die virtuelle Funktion DrawItem der entsprechenden Klasse aufgerufen.Überschreiben Sie die DrawItem-Memberfunktion der entsprechenden Klasse des Steuerelements, um das Element zu zeichnen.

Hinweis
Diese Memberfunktion wird vom Framework aufgerufen, um die Anwendung zu ermöglichen, eine Windows-Meldung zu bearbeiten.Die Parameter, die an die Funktion übergeben werden, geben die Parameter, die vom Framework empfangen werden, als die Nachricht empfangen wurde.Wenn Sie die Basisklassenimplementierung dieser Funktion aufrufen, verwendet diese Implementierung die Parameter, die mit der Meldung übergeben werden und nicht die Parameter, die an die Funktion bereitstellen.

Diese Memberfunktion wird vom Framework aufgerufen, um die Anwendung zu ermöglichen, eine Windows-Meldung zu bearbeiten.Die Parameter, die an die Funktion übergeben werden, geben die Parameter, die vom Framework empfangen werden, als die Nachricht empfangen wurde.Wenn Sie die Basisklassenimplementierung dieser Funktion aufrufen, verwendet diese Implementierung die Parameter, die mit der Meldung übergeben werden und nicht die Parameter, die an die Funktion bereitstellen.