Función DrawStatusTextW (commctrl.h)

La función DrawStatusText dibuja el texto especificado en el estilo de una ventana de estado con bordes.

Sintaxis

void DrawStatusTextW(
  HDC     hDC,
  LPCRECT lprc,
  LPCWSTR pszText,
  UINT    uFlags
);

Parámetros

hDC

Tipo: HDC

Identificador del contexto de presentación de la ventana.

lprc

Tipo: LPCRECT

Puntero a una estructura RECT que contiene la posición, en coordenadas de cliente, del rectángulo en el que se dibuja el texto. La función dibuja los bordes justo dentro de los bordes del rectángulo especificado.

pszText

Tipo: LPCTSTR

Puntero a una cadena terminada en null que especifica el texto que se va a mostrar. Los caracteres de tabulación de la cadena determinan si la cadena está alineada a la izquierda, alineada a la derecha o centrada.

uFlags

Tipo: UINT

Marcas de dibujo de texto. Este parámetro puede ser una combinación de estos valores:

Valor	Significado
SBT_NOBORDERS	Impide que los bordes se dibujen alrededor del texto especificado.
SBT_POPOUT	Dibuja bordes resaltados que hacen que el texto destaque.
SBT_RTLREADING	Indica que la cadena a la que apunta pszText se mostrará en la dirección opuesta al texto de la ventana primaria.

Valor devuelto

None

Observaciones

Las ventanas normales muestran texto de izquierda a derecha (LTR). Windows se puede reflejar para mostrar idiomas como hebreo o árabe que leen de derecha a izquierda (RTL). Normalmente, la cadena pszText se mostrará en la misma dirección que el texto en su ventana primaria. Si se establece SBT_RTLREADING, la cadena pszText leerá en la dirección opuesta del texto de la ventana primaria.

Nota

El encabezado commctrl.h define DrawStatusText como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	commctrl.h
Library	Comctl32.lib
Archivo DLL	Comctl32.dll