Función DrawTextExPrivWrap
[DrawTextExPrivWrap 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 DrawTextEx directamente en su lugar.
Dibuja texto con formato en el rectángulo especificado. Esta función ajusta una llamada a DrawTextEx.
Sintaxis
int WINAPI DrawTextExPrivWrap(
_In_ HDC hdc,
_Inout_ LPTSTR lpchText,
_In_ int cchText,
_Inout_ LPRECT lprc,
_In_ UINT dwDTFormat,
_In_ LPDRAWTEXTPARAMS lpDTParams
);
Parámetros
-
hdc [in]
-
Tipo: HDC
Identificador del contexto del dispositivo en el que se va a dibujar.
-
lpchText [in, out]
-
Tipo: LPTSTR
Puntero a un búfer que contiene el texto que se va a dibujar. Si el parámetro cchText es -1, la cadena debe terminar en null.
Si dwDTFormat 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.
-
cchText [in]
-
Tipo: int
Longitud de la cadena a la que apunta lpchText. Si cchText es -1, se supone que el parámetro lpchText es un puntero a una cadena terminada en null y DrawTextEx calcula automáticamente el recuento de caracteres.
-
lprc [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.
-
dwDTFormat [in]
-
Tipo: UINT
Opciones de formato. Consulte la documentación de DrawTextEx 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 ejecuta 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 la función no se realiza correctamente, el valor devuelto es cero.
Para obtener información de error extendida, llame a GetLastError.
Comentarios
DrawTextExPrivWrap no se exporta por nombre ni se declara en un archivo de encabezado público. Para usarlo, debe usar GetProcAddress y solicitar ordinal 416 desde ComCtl32.dll para obtener un puntero de función.
Para obtener más comentarios, consulte DrawTextEx.
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 |
|