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