CDC::DrawState

Artigo
02/25/2013

Chamar essa função de membro para exibir uma imagem e aplicar um efeito visual para indicar um estado, como um estado padrão ou desativado.

Observação
Para todos os estados de nFlag exceto DSS_NORMAL, a imagem é convertida para o monochrome antes que o efeito visual seja aplicado.

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 tamanho da imagem.
hBitmap
Um identificador para um bitmap.
nFlags
Sinalizadores que especificam o tipo e o estado da imagem.Consulte DrawState em Windows SDK para os tipos e os estados de possíveis nFlags .
hBrush
Um identificador para um pincel.
pBitmap
Um ponteiro para um objeto de CBitmap.
pBrush
Um ponteiro para um objeto de CBrush.
hIcon
Um identificador para um ícone.
lpszText
Um ponteiro para texto.
bPrefixText
Texto que pode conter um mnemônico de aceleração.O parâmetro de lData especifica o endereço de cadeia de caracteres, e o parâmetro de nTextLen especifica o comprimento.Se nTextLen é 0, a cadeia de caracteres será adotado NULL- seja finalizada.
nTextLen
O comprimento da cadeia de caracteres de texto apontado por lpszText.Se nTextLen é 0, a cadeia de caracteres será adotado NULL- seja finalizada.
lpDrawProc
Um ponteiro para um função de retorno de chamada usada para processar uma imagem.Esse parâmetro é necessário se a imagem em nFlags é DST_COMPLEX.É opcional e pode ser NULO se o tipo de imagem é DST_TEXT.Para todos os outros tipos de imagem, este parâmetro é ignorado.Para obter mais informações sobre a função de retorno de chamada, consulte a função de DrawStateProc em Windows SDK.
lData
Especifica informações sobre a imagem.O significado de este parâmetro depende do tipo da imagem.