Função SetTextCharacterExtra (wingdi.h)
A função SetTextCharacterExtra define o espaçamento entre caracteres. O espaçamento entre caracteres é adicionado a cada caractere, incluindo caracteres de quebra, quando o sistema grava uma linha de texto.
Sintaxe
int SetTextCharacterExtra(
[in] HDC hdc,
[in] int extra
);
Parâmetros
[in] hdc
Um identificador para o contexto do dispositivo.
[in] extra
A quantidade de espaço extra, em unidades lógicas, a ser adicionada a cada caractere. Se o modo de mapeamento atual não for MM_TEXT, o parâmetro nCharExtra será transformado e arredondado para o pixel mais próximo.
Retornar valor
Se a função for bem-sucedida, o valor retornado será o espaçamento entre caracteres anterior.
Se a função falhar, o valor retornado será 0x80000000.
Comentários
Essa função tem suporte principalmente para compatibilidade com aplicativos existentes. Os novos aplicativos geralmente devem evitar chamar essa função, pois ela é incompatível com scripts complexos (scripts que exigem formatação de texto; O script árabe é um exemplo disso).
A abordagem recomendada é que, em vez de chamar essa função e, em seguida, TextOut, os aplicativos devem chamar ExtTextOut e usar seu parâmetro lpDx para fornecer larguras.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 2000 Professional [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows 2000 Server [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | wingdi.h (inclua Windows.h) |
| Biblioteca | Gdi32.lib |
| DLL | Gdi32.dll |