CDC::DrawState

BOOL DrawState (CPoint pt, CSize Tamanho, HBITMAP hBitmap, UINT nFlags, HBRUSH hBrush = NULL);

BOOL DrawState (CPoint pt, CSize Tamanho, CBitmap * pBitmap, UINT nFlags, CBrush * pBrush = NULL);

BOOL DrawState (CPoint pt, CSize Tamanho, HICON hIcon, UINT nFlags, HBRUSH hBrush = NULL);

BOOL DrawState (CPoint pt, CSize Tamanho, HICON hIcon, UINT nFlags, CBrush * pBrush = NULL);

BOOL DrawState (CPoint pt, CSize Tamanho, LPCTSTR lpszText, UINT nFlags, BOOL bPrefixText = TRUE, int nTextLen = 0, HBRUSH hBrush = NULL);

BOOL DrawState (CPoint pt, CSize Tamanho, LPCTSTR lpszText, UINT nFlags, BOOL bPrefixText = TRUE, int nTextLen = 0, CBrush * pBrush = NULL);

BOOL DrawState (CPoint pt, CSize Tamanho, DRAWSTATEPROC lpDrawProc, LPARAM lData, UINT nFlags, HBRUSH hBrush = NULL);

BOOL DrawState (CPoint pt, CSize Tamanho, DRAWSTATEPROC lpDrawProc, LPARAM lData, UINT nFlags, CBrush * pBrush = NULL);

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário 0.

Parâmetros

pt

Especifica a localização da imagem.

tamanho

Especifica o tamanho da imagem.

hBitmap

Um identificador para um bitmap.

nFlags

Sinalizadores que especificam o tipo de imagem e o Estado. Consulte a seção de comentários para os tipos possíveis nFlags 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 o texto.

bPrefixText

Texto que pode conter um mneumônico de acelerador. O parâmetro lData especifica o endereço da Cadeia de caracteres, e o parâmetro nTextLen especifica o comprimento. Se nTextLen for 0, a Cadeia de caracteres será considerada terminada por caractere nulo.

nTextLen

Comprime&nto do seqüência de caracteres de texto apontado pelo lpszText.nbsp; Se nTextLen for 0, a Cadeia de caracteres será considerada terminada por caractere nulo.

lpDrawProc

Um ponteiro para uma função de retorno de chamada usado para processar uma imagem. Este parâmetro é obrigatório se o tipo de imagem em nFlags for DST_COMPLEX. É opcional e pode ser NULL se o tipo de imagem é DST_TEXT. Para todos os outros tipos de imagem, este parâmetro é ignorado. Para obter mais informações sobre o função callback, consulte o :: DrawStateProc função na Referência do programador do Win32 SDK.

lData

Especifica informações sobre a imagem. O significado desse parâmetro depende do tipo de imagem.

Observações

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

O tipo de nFlag parâmetro pode ser definido como um dos valores a seguir:

• DST_BITMAP   A imagem é um bitmap. A palavra de ordem inferior do parâmetro lData é o identificador de bitmap.
  
  
• DST_COMPLEX   A imagem é definida pelo aplicativo. Para processar a imagem, DrawState chama o função callback especificado pelo parâmetro lpDrawProc.
  
  
• DST_ICO&Nnbsp;  A imagem é um ícone. A baixa-ordem palavra de lData é o identificador de ícone.
  
  
• DST_PREFIXTEXTnbsp;  A imagem é o texto que pode conter um mneumônico de acelerador. DrawState interpreta o caractere de prefixo "e" comercial (&) como uma diretiva para sublinhado o caractere que segue. O parâmetro lData especifica o endereço da Cadeia de caracteres.
  
  
• DST_TEXT   A imagem é texto. O parâmetro lData especifica o endereço da Cadeia de caracteres.

O estado de nFlag parâmetro pode ser um dos seguintes valores:

• DSS_&NORMALnbsp;  Desenha a imagem sem nenhuma modificação.
  
  
• DSS_U&NIONnbsp;  Dithers a imagem.
  
  
• DSS_DISABLED   Aplica relevo a imagem.
  
  
• DSS_DEFAULT   Aplica negrito a imagem.
  
  
• DSS_MO&NOnbsp;  Desenha a imagem usando o pincel especificado pelo parâmetro hBrush ou pBrush.

&Notanbsp;  Para todos os nFlag Estados exceto DSS_NORMAL, a imagem é convertida em monocromático antes que o efeito visual é aplicado.

Para obter mais informações sobre a API do Windows DrawState, consulte :: DrawState na Referência do programador do Win32 SDK.

Visão geral do CDC |  Membros de classe | Gráfico de hierarquia

Co&nsulte tambémnbsp; ::DrawState, ::DrawStateProc