Función SetTextCharacterExtra (wingdi.h)

  • Artículo

La función SetTextCharacterExtra establece el espaciado intercharacter. El espaciado entre caracteres se agrega a cada carácter, incluidos los caracteres de interrupción, cuando el sistema escribe una línea de texto.

Sintaxis

int SetTextCharacterExtra(
  [in] HDC hdc,
  [in] int extra
);

Parámetros

[in] hdc

Identificador del contexto del dispositivo.

[in] extra

Cantidad de espacio adicional, en unidades lógicas, que se agregará a cada carácter. Si el modo de asignación actual no es MM_TEXT, el parámetro nCharExtra se transforma y redondea al píxel más cercano.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el espaciado intercharacter anterior.

Si se produce un error en la función, el valor devuelto es 0x80000000.

Comentarios

Esta función se admite principalmente para la compatibilidad con las aplicaciones existentes. Por lo general, las nuevas aplicaciones deben evitar llamar a esta función, ya que no es compatible con scripts complejos (scripts que requieren forma de texto; El script árabe es un ejemplo de esto).

El enfoque recomendado es que, en lugar de llamar a esta función y, a continuación, TextOut, las aplicaciones deben llamar a ExtTextOut y usar su parámetro lpDx para proporcionar anchos.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado wingdi.h (incluye Windows.h)
Library Gdi32.lib
Archivo DLL Gdi32.dll

Consulte también

Drawtext

Funciones de fuente y texto

Información general sobre fuentes y texto

GetTextCharacterExtra

TextOut