Función ExtTextOutWrap
[ExtTextOutWrap está disponible a través de Windows XP con Service Pack 2 (SP2). Es posible que se modifique o no esté disponible en versiones posteriores. Se recomienda usar ExtTextOut directamente en su lugar.
Dibuja texto con la fuente seleccionada actualmente, el color de fondo y el color de texto. Opcionalmente, puede proporcionar dimensiones que se usarán para recortar, opacidad o ambas. Esta función ajusta una llamada a ExtTextOut.
Sintaxis
BOOL ExtTextOutWrap(
_In_ HDC hdc,
_In_ int X,
_In_ int Y,
_In_ UINT uOptions,
_In_ const RECT *lprc,
_In_ LPCTSTR lpString,
_In_ UINT cbCount,
_In_ const INT *lpDx
);
Parámetros
-
hdc [in]
-
Tipo: HDC
Identificador del contexto del dispositivo.
-
X [in]
-
Tipo: int
Coordenada x, en coordenadas lógicas, del punto de referencia utilizado para colocar la cadena.
-
Y [in]
-
Tipo: int
Coordenada y, en coordenadas lógicas, del punto de referencia utilizado para colocar la cadena.
-
uOptions [in]
-
Tipo: UINT
Valores que especifican cómo usar el rectángulo definido por la aplicación. Consulte ExtTextOut para obtener una lista completa de las opciones.
-
lprc [in]
-
Tipo: const RECT*
Puntero a una estructura RECT opcional que especifica las dimensiones, en coordenadas lógicas, de un rectángulo que se usa para recortar, opacidad o ambos.
-
lpString [in]
-
Tipo: LPCTSTR
Puntero a un búfer que contiene el texto que se va a dibujar. La cadena no necesita terminar en cero, ya que cbCount especifica la longitud de la cadena.
-
cbCount [in]
-
Tipo: UINT
Longitud de la cadena, en bytes, a la que apunta lpString.
-
lpDx [in]
-
Tipo: const INT*
Puntero a una matriz opcional de valores que indican la distancia entre los orígenes de las celdas de caracteres adyacentes. Por ejemplo, las unidades lógicas lpDx[x] separan los orígenes de la celda de caracteres x y la celda de caracteres (x + 1).
Valor devuelto
Tipo: BOOL
Devuelve un valor distinto de cero si la cadena se dibuja correctamente. Sin embargo, si se llama a la versión ANSI de ExtTextOut con ETO_GLYPH_INDEX, la función devuelve TRUE aunque la función no haga nada.
Si la función no se realiza correctamente, el valor devuelto es cero.
Para obtener información de error extendida, llame a GetLastError.
Comentarios
ExtTextOutWrap no se exporta por nombre ni se declara en un archivo de encabezado público. Para usarlo, debe usar GetProcAddress y solicitar ordinal 417 desde ComCtl32.dll para obtener un puntero de función.
Para obtener más comentarios, consulte ExtTextOut.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible |
Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible |
Windows Server 2003 [solo aplicaciones de escritorio] |
| Archivo DLL |
|