Función DrawTextWrap
[DrawTextWrap está disponible a través de Windows XP con Service Pack 2 (SP2). Puede modificarse o no estar disponible en versiones posteriores. Se recomienda usar DrawText directamente en su lugar.
Dibuja texto con formato en el rectángulo especificado. Da formato al texto según el método especificado (expandiendo fichas, justificando caracteres, líneas de separación, etc.). Esta función ajusta una llamada a DrawText.
Sintaxis
int WINAPI DrawTextWrap(
_In_ HDC hdc,
_Inout_ LPCTSTR lpString,
_In_ int nCount,
_Inout_ LPRECT lpRect,
_In_ UINT uFormat,
_In_ LPDRAWTEXTPARAMS lpDTParams
);
Parámetros
-
hdc [in]
-
Tipo: HDC
Identificador del contexto del dispositivo.
-
lpString [in, out]
-
Tipo: LPCTSTR
Puntero a un búfer que contiene el texto que se va a dibujar. Si el parámetro nCount es -1, la cadena debe terminar en null.
Si uFormat incluye DT_MODIFYSTRING, la función puede agregar hasta cuatro caracteres adicionales a esta cadena. El búfer que contiene la cadena debe ser lo suficientemente grande como para acomodar estos caracteres adicionales.
-
nCount [in]
-
Tipo: int
Longitud de la cadena a la que apunta lpString. Si nCount es -1, se supone que el parámetro lpString es un puntero a una cadena terminada en null y DrawText calcula automáticamente el recuento de caracteres.
-
lpRect [in, out]
-
Tipo: LPRECT
Puntero a una estructura RECT que contiene el rectángulo, en coordenadas lógicas, en las que se va a dar formato al texto.
-
uFormat [in]
-
Tipo: UINT
Opciones de formato. Consulte la documentación de DrawText para obtener una lista completa de las opciones.
-
lpDTParams [in]
-
Tipo: LPDRAWTEXTPARAMS
Puntero a una estructura DRAWTEXTPARAMS que especifica opciones de formato adicionales. Este parámetro puede ser NULL.
Valor devuelto
Tipo: int
Si la función se realiza correctamente, el valor devuelto es el alto del texto en unidades lógicas. Si se especifica DT_VCENTER o DT_BOTTOM , el valor devuelto es el desplazamiento del miembro superior de lprc a la parte inferior del texto dibujado Si se produce un error en la función, el valor devuelto es cero.
Si la función no se realiza correctamente, el valor devuelto es cero.
Para obtener información de error extendida, llame a GetLastError.
Comentarios
DrawTextWrap no se exporta por nombre ni se declara en un encabezado público. Para usarlo, debe usar GetProcAddress y solicitar ordinal 415 desde ComCtl32.dll para obtener un puntero de función.
Para obtener comentarios adicionales, consulte DrawText.
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 |
|