Compartilhar via


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

Confira também

Drawtext

Funções de fonte e texto

Visão geral de fontes e texto

GetTextCharacterExtra

Textout