CDC::GrayString

Artigo
08/25/2010

Desenha esmaecida texto (cinza) no local fornecido por escrever o texto em um bitmap de memória, o bitmap de esmaecimento e, em seguida, copiando o bitmap para a Exibir.

virtual BOOL GrayString(
   CBrush* pBrush,
   BOOL ( CALLBACK* lpfnOutput )( HDC, LPARAM, int ),
   LPARAM lpData,
   int nCount,
   int x,
   int y,
   int nWidth,
   int nHeight
);

Parâmetros

pBrush
Identifica o pincel a ser usado para dimming (graying).
lpfnOutput
Especifica o endereço de instância de procedimento da função de retorno de chamada fornecido do aplicativo que irá desenhar a Cadeia de Caracteres.Para obter mais informações, consulte a descrição do Windows OutputFuncretorno de chamada função.Se este parâmetro é NULL, o sistema usa a função de TextOut Windows para desenhar a Cadeia de Caracteres e lpData será considerado um ponteiro longo para a Cadeia de Caracteres a ser saída.
lpData
Especifica um ponteiro até que ponto para dados a ser passado para a função de saída.Se lpfnOutput for NULL, lpData deve ser um ponteiro longo para a Cadeia de Caracteres para saída.
nCount
Especifica o número de caracteres como saída.Se este parâmetro for 0, GrayString calcula o ComComprimento da Cadeia de Caracteres (supondo que lpData é um ponteiro para a Cadeia de Caracteres).Se nCount é – 1 e a função apontada pelo lpfnOutput retorna 0, a imagem é mostrada, mas não esmaecida.
x
Especifica a lógica coordenada x da posição inicial do Retangular que inclui a Cadeia de Caracteres.
y
Especifica a lógica coordenada y da posição inicial do Retangular que inclui a Cadeia de Caracteres.
nWidth
Especifica a largura (nas unidades lógicas) do Retangular que inclui a Cadeia de Caracteres.Se nWidth for 0, GrayString calculará a largura da área, assumindo que lpData é um ponteiro para a Cadeia de Caracteres.
nHeight
Especifica a altura (em unidades lógicas) do Retangular que inclui a Cadeia de Caracteres.Se nHeight for 0, GrayString calculará a altura da área, assumindo que lpData é um ponteiro para a Cadeia de Caracteres.

Valor de retorno

Diferente de zero se a Cadeia de Caracteres é desenhada, ou 0 se tanto a função TextOut ou a função de saída fornecido de aplicativo retornou 0, ou se a memória insuficiente para criar um bitmap de memória para o esmaecimento.

Comentários

A função, o texto, independentemente do Pincel selecionado e o plano de fundo são obscurecidas.A função de membro GrayString usa a fonte selecionada no momento.O modo de mapeamento MM_TEXT deve ser selecionado antes de usar essa função.

Um aplicativo pode desenhar esmaecidas seqüências de caracteres (sombreadas) em dispositivos que suportam uma cor cinza Sólido sem chamar a função de membro GrayString.O sistema cor COLOR_GRAYTEXT é a cor de sistema cinza Sólido usada para desenhar texto Desativado.O aplicativo pode chamar de GetSysColor de função do Windows para recuperar o valor da cor de COLOR_GRAYTEXT.Se a cor é diferente de 0 (preto), o aplicativo pode chamar a função de membro SetTextColor para definir Cor do Texto como o valor de cor e, em seguida, Desenhar diretamente a Cadeia de Caracteres.Se a cor recuperada é preto, o aplicativo deve chamar GrayString para esmaecer (cinza) o texto.

Se lpfnOutputNULL, GDI usa o Windows TextOut função e lpData será considerado um ponteiro até que ponto para o caractere a ser saída.Se os caracteres a ser saída não podem ser tratados pela função de membro TextOut (por exemplo, a Cadeia de Caracteres é armazenada como um bitmap), o aplicativo deve fornecer sua própria função de saída.

Anotação também que todas as funções de retorno de chamada devem interceptar exceções Microsoft Foundation antes de retornar ao Windows, desde que as exceções não podem ser lançadas através de limites de retorno de chamada.Para obter mais informações sobre exceções, consulte o artigo exceções.

A função de retorno de chamada passada para GrayString deve usar __stdcall convenção de chamada e deve ser exportada com __declspec.

Quando a estrutura está no modo de Visualizar, uma chamada para a função de membro GrayString é convertida para uma chamada TextOut, e a função de retorno de chamada não é chamada.