CDC::GrayString
Desenha texto escurecido (cinza) na localidade determinada gravar texto em um bitmap de memória, escurecendo o bitmap, e depois copiar o bitmap serem exibidos.
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 usada escurecendo (graying).lpfnOutput
Especifica o endereço de procedimento - o instância de função de retorno de chamada fornecida aplicativo que irá desenhar a cadeia de caracteres. Para obter mais informações, consulte a descrição do windows OutputFunc função de retorno de chamada. Se esse parâmetro é NULO, o sistema usa a função de TextOut do windows para desenhar a cadeia de caracteres, e lpData é assumido ser longo um ponteiro para a cadeia de caracteres a ser saída.lpData
Especifica um ponteiro distante a dados a serem passados à função de saída. Se lpfnOutput é NULO, lpData deve ser um ponteiro longo para a cadeia de caracteres a ser saída.nCount
Especifica o número de caracteres a ser saída. Se esse parâmetro é 0, GrayString calcula o tamanho da cadeia de caracteres (supondo que lpData é um ponteiro para a cadeia de caracteres). Se nCount é – 1 e a função apontada por lpfnOutput retorna 0, a imagem é mostrado mas não esmaecido.x
Especifica a coordenada x lógica da posição inicial do retângulo que inclui a cadeia de caracteres.s
Especifica a coordenada y lógica da posição inicial do retângulo que inclui a cadeia de caracteres.nWidth
Especifica a largura (em unidades lógicas) do retângulo que inclui a cadeia de caracteres. Se nWidth é 0, GrayString calcula a largura da área, supondo que lpData é um ponteiro para a cadeia de caracteres.nHeight
Especifica a altura (em unidades lógicas) do retângulo que inclui a cadeia de caracteres. Se nHeight é 0, GrayString calcula a altura da área, supondo que lpData é um ponteiro para a cadeia de caracteres.
Valor de retorno
Diferente de zero se a cadeia de caracteres é desenhada, ou 0 se a função de TextOut ou a função de saída fornecida em returnado 0, ou se houver uma insuficiente memória para criar um bitmap de memória para escurecer.
Comentários
A função escurece o texto independentemente do pincel e do plano de fundo selecionados. A função de membro de GrayString usa a fonte selecionada. MM_TEXT que mapeia o modo deve ser selecionado antes de usar essa função.
Um aplicativo pode desenhar cadeias de caracteres (cinza para permanecerá esmaecido) em dispositivos que suportam uma cor sólida cinza sem chamar a função de membro de GrayString . COLOR_GRAYTEXT a cor do sistema é a cor cinza contínuo- do sistema usada para desenhar texto desativado. O aplicativo pode chamar a função do windows de GetSysColor para recuperar o valor de cor COLOR_GRAYTEXT. Se a cor é diferente de 0 (preto), o aplicativo pode chamar a função de membro de SetTextColor para definir a cor do texto ao valor de cor e para desenhar diretamente na cadeia de caracteres. Se a cor é recuperada preta, o aplicativo deve chamar GrayString para escurecer (cinza) o texto.
Se lpfnOutput é NULO, GDI usa a função de TextOut do windows, e lpData é assumido ser um ponteiro distante ao caractere a ser saída. Se os caracteres a serem saída não podem ser tratados pela função de membro de TextOut (por exemplo, a cadeia de caracteres é armazenada como um bitmap), o aplicativo deve fornecer sua própria função de saída.
Observe também que todas as funções de retorno de chamada devem interceptar exceções de Microsoft foundation antes de retornar ao, desde que as exceções não podem ser lançadas através dos limites de retorno de chamada. Para obter mais informações sobre as exceções, consulte o artigo Exceções.
A função de retorno de chamada passada para GrayString deve usar __stdcall que chama a convenção e deve ser exportadas com __declspec.
Quando a estrutura está no modo de visualização, uma chamada para a função de membro de GrayString ele é convertido para uma chamada de TextOut , e a função de retorno de chamada não é chamada.
Requisitos
Cabeçalho: afxwin.h