mensaje de SB_GETTEXT

Recupera el texto de la parte especificada de una ventana de estado.

Parámetros

wParam

Índice de base cero del elemento desde el que se va a recuperar texto.

lParam

Puntero al búfer que recibe el texto como una cadena terminada en null. Use el mensaje SB_GETTEXTLENGTH para determinar el tamaño necesario del búfer.

Valor devuelto

Devuelve un valor de 32 bits que consta de dos valores de 16 bits. La palabra baja especifica la longitud, en caracteres, del texto. La palabra alta especifica el tipo de operación que se usa para dibujar el texto. El tipo puede ser uno de los valores siguientes.

Código devuelto	Descripción
0	El texto se dibuja con un borde que aparece inferior al plano de la ventana.
SBT_NOBORDERS	El texto se dibuja sin bordes.
SBT_POPOUT	El texto se dibuja con un borde para que aparezca más alto que el plano de la ventana.
SBT_RTLREADING	El texto se muestra en la dirección opuesta del texto en la ventana primaria.

Observaciones

Advertencia de seguridad: El uso de este mensaje incorrectamente puede poner en peligro la seguridad de su programa. Este mensaje no proporciona una manera de conocer el tamaño del búfer. Si usa este mensaje, llame primero a SB_GETTEXTLENGTH para obtener el número de caracteres necesarios y, a continuación, llame al mensaje para recuperar la cadena. Si espera antes de llamar a SB_GETTEXT el texto podría cambiar, lo que invalida el valor devuelto de SB_GETTEXTLENGTH. Debe revisar las consideraciones de seguridad: controles de Microsoft Windows antes de continuar.

Este mensaje devuelve un máximo de 65 535 caracteres. Si la cadena de texto es mayor que esa, se trunca.

Si el texto tiene el tipo de dibujo SBT_OWNERDRAW, este mensaje devuelve el valor de 32 bits asociado al texto en lugar del tipo de operación y longitud.

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). Si se establece SBT_RTLREADING, la cadena lParam lee en la dirección opuesta del texto de la ventana primaria.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	Commctrl.h
Nombres Unicode y ANSI	SB_GETTEXTW (Unicode) y SB_GETTEXTA (ANSI)

Consulte también

SB_SETTEXT