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 CDC | Membros de classe | Gráfico de hierarquia
Consulte tambémnbsp;CDC::SetTextAlign, CDC::TabbedTextOut, CDC::TextOut, CDC::GetBkColor, CDC, CDC::SetTextColor, :: ExtTextOut, RECT