CDC::DrawState

Artigo
08/25/2010

Chame essa função de membro para exibir uma imagem e aplicar um efeito visual para indicar um estado, sistema autônomo um desabilitado ou o estado padrão.

Observação:
Para todas as nFlag estados, exceto DSS_NORMAL, a imagem é convertida em monocromático antes de aplicar o efeito visual.

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 
);

Parâmetros

pt
Especifica o local da imagem.
size
Especifica o dimensionar da imagem.
hBitmap
Um identificador para um bitmap.
nFlags
Sinalizadores que especificam o tipo de imagem e o estado.See DrawState in the Windows SDK para possíveis nFlags tipos e estados.
hBrush
Um identificador para um pincel.
pBitmap
Um ponteiro para um objeto CBitmap.
pBrush
Um ponteiro para um objeto CBrush.
hIcon
Um identificador para um ícone.
lpszText
Um ponteiro para texto.
bPrefixText
Texto que pode conter um mnemônico do acelerador.The lData parâmetro especifica o endereço da seqüência de caracteres e o nTextLen parâmetro especifica o comprimento. If nTextLen é 0, a seqüência de caracteres será considerada terminada com caractere nulo.
nTextLen
Comprimento da seqüência de caracteres de texto apontada por lpszText. If nTextLen é 0, a seqüência de caracteres será considerada terminada com caractere nulo.
lpDrawProc
Um ponteiro para uma função de retorno de chamada usado para processar uma imagem.Este parâmetro é obrigatório se a imagem digitar nFlags é DST_COMPLEX.Ele é opcional e pode ser NULO se o tipo de imagem é DST_TEXT.Este parâmetro é ignorado para todos os outros tipos de imagem.Para obter mais informações sobre a função de retorno de chamada, consulte o DrawStateProc função de a Windows SDK.
lData
Especifica as informações sobre a imagem.O significado desse parâmetro depende do tipo de imagem.