INameSpaceTreeControlCustomDraw::ItemPrePaint-Methode (shobjidl.h)

Artikel
03/02/2024

Wird aufgerufen, bevor ein Element im Namespacestruktursteuerelement gezeichnet wird.

Syntax

HRESULT ItemPrePaint(
  [in]      HDC            hdc,
  [in]      RECT           *prc,
  [in]      NSTCCUSTOMDRAW *pnstccdItem,
  [in, out] COLORREF       *pclrText,
  [in, out] COLORREF       *pclrTextBk,
  [out]     LRESULT        *plres
);

Parameter

[in] hdc

Typ: HDC

Ein Handle für den Gerätekontext des Steuerelements. Verwenden Sie diesen HDC, um GDI-Funktionen auszuführen.

[in] prc

Typ: RECT*

Ein Zeiger auf die RECT-Struktur , der das umgebende Rechteck des gezeichneten Bereichs beschreibt.

[in] pnstccdItem

Typ: NSTCCUSTOMDRAW*

Ein Zeiger auf die NSTCCUSTOMDRAW-Struktur , die die Details der Zeichnung bestimmt.

[in, out] pclrText

Typ: COLORREF*

Beim Eintrag ein Zeiger auf eine COLORREF-Struktur , die die Standardfarbe des Texts deklariert. Wenn diese Methode zurückgibt, enthält einen Zeiger auf eine COLORREF-Struktur , die die Farbe deklariert, die an ihrer Stelle verwendet werden soll, falls vorhanden. Dadurch kann der Client eine eigene Farbe angeben, wenn er die Standardeinstellung nicht verwenden möchte.

[in, out] pclrTextBk

Typ: COLORREF*

Beim Einstieg ein Zeiger auf eine COLORREF-Struktur , die die Standardfarbe des Hintergrunds deklariert. Wenn diese Methode zurückgibt, enthält einen Zeiger auf eine COLORREF-Struktur , die die Farbe deklariert, die an ihrer Stelle verwendet werden soll, falls vorhanden. Dadurch kann der Client eine eigene Farbe angeben, wenn er die Standardeinstellung nicht verwenden möchte.

[out] plres

Typ: LRESULT*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein LRESULT, das auf einen oder mehrere Der Werte aus der CDRF-Konstanten-Enumeration verweist.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Anforderungen

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

Weitere Informationen

INameSpaceTreeControlCustomDraw

Freigeben über