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	Comctl32.dll (versión 6.0 o posterior)