CDC::ExtTextOut

virtual BOOL ExtTextOut ( int x, int y, UINT nOptions, Operador LPCRECT lpRect, LPCTSTR lpszString, UINT nCount, LPINT lpDxWidths );

BOOL ExtTextOut (int x, int y, UINT nOptions, Oper&ador LPCRECT lpRectCStringamp const;StrLPINTlpDxWidths );

Valor de retorno

Diferente de zero se a função for bem-sucedida; caso contrário 0.

Parâmetros

x

Especifica o x lógica-coordenar da célula caracteres para o primeiro caractere na cadeia de caracteres especificada.

y

Especifica a y lógica-coordenar da parte superior da célula caracteres para o primeiro caractere na cadeia de caracteres especificada.

nOptions

Especifica o tipo de retângulo. Este parâmetro pode ser um, ambos ou nenhum dos valores a seguir:

lpRect

Aponta para um RECT estrutura que determina as dimensões do Retangular. Este parâmetro pode ser NULL. Você também pode passar um objeto de CRect para este parâmetro.

lpszString

Aponta para a Cadeia de caracteres especificados ser desenhado. Você também pode passar um objeto CString para este parâmetro.

nCount

Especifica o número de caracteres na cadeia de caracteres.

lpDxWidths

Aponta para uma matriz de valores que indicam a distância entre origens de células de caractere adjacente. Por exemplo, unidades lógicas lpDxWidths[eu] irão separar as origens do personagem célula eu e personagem célula eu + 1. Se lpDxWidths for NULL, ExtTextOut usa o espaçamento padrão entre caracteres.

str

 Um objeto de CString que contém os caracteres especificados ser desenhado.

Observações

Chame essa função de membro para gravar uma Cadeia de caracteres dentro de uma região retangular usando a fonte selecionada no momento. A região retangular pode ser opaca (preenchida com a cor de plano de fundo atual), e pode ser um região de recorte.

Se nOptions é 0 e lpRect é NULL, a função grava o texto para o contexto dispositivo sem usar uma região retangular. Por padrão, a posição atual não é usada ou atualizada pela função. Se um aplicativo precisa atualizar a posição atual quando ele chama ExtTextOut, o aplicativo pode chamar o CDC membro função SetTextAlign com nFlags definido como TA_UPDATECP. Quando este sinalizador estiver definido, o Windows ignora x e y em chamadas subseqüentes a ExtTextOut e usa a posição atual em vez disso. Quando um aplicativo usa TA_UPDATECP para atualizar a posição atual, ExtTextOut define a posição atual para o final da linha anterior do texto ou para a posição especificada pelo último elemento da matriz apontado pelo lpDxWidths, consoante o que for maior.

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

Consulte tambémnbsp;CDC::SetTextAlign, CDC::TabbedTextOut, CDC::TextOut, CDC::GetBkColor, CDC, CDC::SetTextColor, :: ExtTextOut, RECT

Index