Compartir a través de


Función DrawStatusTextA (commctrl.h)

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

Sintaxis

void DrawStatusTextA(
  HDC     hDC,
  LPCRECT lprc,
  LPCSTR  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 de 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o 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