mensaje de SB_GETTEXT

  • Artículo

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