CDC::DrawState

Articolo
03/05/2013

Chiamare la funzione membro per visualizzare un'immagine e applicare un effetto visivo per indicare uno stato, ad esempio uno stato disabilitato o predefinito.

[!NOTA]

Per tutti gli stati nFlag tranne DSS_NORMAL, l'immagine viene convertita in monocromio prima dell'effetto visivo applicabile.

BOOL DrawState(
   CPoint pt,
   CSize size,
   HBITMAP hBitmap,
   UINT nFlags,
   HBRUSH hBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   CBitmap* pBitmap,
   UINT nFlags,
   CBrush* pBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   HICON hIcon,
   UINT nFlags,
   HBRUSH hBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   HICON hIcon,
   UINT nFlags,
   CBrush* pBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   LPCTSTR lpszText,
   UINT nFlags,
   BOOL bPrefixText = TRUE,
   int nTextLen = 0,
   HBRUSH hBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   LPCTSTR lpszText,
   UINT nFlags,
   BOOL bPrefixText = TRUE,
   int nTextLen = 0,
   CBrush* pBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   DRAWSTATEPROC lpDrawProc,
   LPARAM lData,
   UINT nFlags,
   HBRUSH hBrush = NULL 
);
BOOL DrawState(
   CPoint pt,
   CSize size,
   DRAWSTATEPROC lpDrawProc,
   LPARAM lData,
   UINT nFlags,
   CBrush* pBrush = NULL 
);

Parametri

pt
Specifica la posizione dell'immagine.
size
Specifica la dimensione dell'immagine.
hBitmap
Handle a una bitmap.
nFlags
Flag che specificano il tipo e lo stato di immagine.Vedere DrawState in Windows SDK per i tipi e gli stati possibili nFlags.
hBrush
Un handle di un pennello.
pBitmap
Un puntatore a un oggetto di CBitmap.
pBrush
Un puntatore a un oggetto di CBrush.
hIcon
Handle per un'icona.
lpszText
Un puntatore al testo.
bPrefixText
Testo che può contenere un tasto di scelta rapida.Il parametro lData specifica l'indirizzo della stringa e il parametro nTextLen specifica la durata.Se nTextLen è 0, la stringa costituisca con terminazione null.
nTextLen
La lunghezza della stringa di testo indicato da lpszText.Se nTextLen è 0, la stringa costituisca con terminazione null.
lpDrawProc
Un puntatore a una funzione di callback utilizzata per eseguire il rendering di un'immagine.Questo parametro è obbligatorio se l'immagine in nFlags è DST_COMPLEX.è facoltativo e può essere NULL se il tipo di immagine è DST_TEXT.Per tutti gli altri tipi di immagine, questo parametro viene ignorato.Per ulteriori informazioni sulla funzione di callback, vedere la funzione DrawStateProc in Windows SDK.
lData
Specifica le informazioni sull'immagine.Il significato di questo parametro dipende dal tipo di immagine.