Estructura REBARBANDINFOW (commctrl.h)
Contiene información que define una banda en un control rebar.
Sintaxis
typedef struct tagREBARBANDINFOW {
UINT cbSize;
UINT fMask;
UINT fStyle;
COLORREF clrFore;
COLORREF clrBack;
LPWSTR lpText;
UINT cch;
int iImage;
HWND hwndChild;
UINT cxMinChild;
UINT cyMinChild;
UINT cx;
HBITMAP hbmBack;
UINT wID;
UINT cyChild;
UINT cyMaxChild;
UINT cyIntegral;
UINT cxIdeal;
LPARAM lParam;
UINT cxHeader;
RECT rcChevronLocation;
UINT uChevronState;
} REBARBANDINFOW, *LPREBARBANDINFOW;
Miembros
cbSize
Tipo: UINT
Tamaño de esta estructura, en bytes. La aplicación debe rellenar este miembro antes de enviar mensajes que usen la dirección de esta estructura como parámetro.
fMask
Tipo: UINT
Marcas que indican qué miembros de esta estructura son válidos o deben rellenarse. Este valor puede ser una combinación de lo siguiente:
| Valor | Significado |
|---|---|
|
El miembro hbmBack es válido o debe establecerse. |
|
El miembro hwndChild es válido o debe establecerse. |
|
Los miembros cxMinChild, cyMinChild, cyChild, cyMaxChild y cyIntegral son válidos o deben establecerse. |
|
Los miembros clrFore y clrBack son válidos o deben establecerse. |
|
Versión 4.71. El miembro cxHeader es válido o debe establecerse. |
|
Versión 4.71. El miembro cxIdeal es válido o debe establecerse. |
|
El miembro wID es válido o debe establecerse. |
|
El miembro iImage es válido o debe establecerse. |
|
Versión 4.71. El miembro lParam es válido o debe establecerse. |
|
El miembro cx es válido o debe establecerse. |
|
El miembro fStyle es válido o debe establecerse. |
|
El miembro lpText es válido o debe establecerse. |
|
El miembro rcChevronLocation es válido o debe establecerse. |
|
El miembro uChevronState es válido o debe establecerse. |
fStyle
Tipo: UINT
Marcas que especifican el estilo de banda. Este valor puede ser una combinación de lo siguiente:
| Valor | Significado |
|---|---|
|
La banda está en una nueva línea. |
|
La banda tiene un borde en la parte superior e inferior de la ventana secundaria. |
|
El mapa de bits de fondo no se mueve cuando se cambia el tamaño de la banda. |
|
No se puede ajustar el tamaño de la banda. Con este estilo, el agarre de tamaño no se muestra en la banda. |
|
Versión 4.71. La banda siempre tendrá un agarre de tamaño, incluso si es la única banda en la barra. |
|
La banda no estará visible. |
|
Versión 4.71. La banda nunca tendrá un agarre de tamaño, incluso si hay más de una banda en la barra de rebar. |
|
Versión 5.80. Muestra un botón de contenido adicional si la banda es menor que cxIdeal. |
|
Versión 4.71. El control de la barra puede cambiar el tamaño de la banda; cyIntegral y cyMaxChild afectan a cómo cambiará el tamaño de la barra. |
|
No se muestre cuando sea vertical. |
|
Mantenga el título de banda oculto. |
|
Mantenga la banda en la parte superior. |
clrFore
Tipo: COLORREF
Colores de primer plano de banda.
clrBack
Tipo: COLORREF
Colores de fondo de banda. Si hbmBack especifica un mapa de bits de fondo, se omiten estos miembros. De forma predeterminada, la banda usará el color de fondo del control rebar establecido con el mensaje RB_SETBKCOLOR . Si se especifica aquí un color de fondo, se usará en su lugar este color de fondo.
lpText
Tipo: LPTSTR
Puntero a un búfer que contiene el texto para mostrar de la banda. Si se solicita información de banda desde el control y RBBIM_TEXT se especifica en fMask, este miembro debe inicializarse en la dirección del búfer que recibirá el texto.
cch
Tipo: UINT
Tamaño del búfer en lpText, en bytes. Si no se solicita información desde el control, se omite este miembro.
iImage
Tipo: int
Índice de base cero de cualquier imagen que se debe mostrar en la banda. La lista de imágenes se establece con el mensaje RB_SETBARINFO .
hwndChild
Tipo: HWND
Identificador de la ventana secundaria contenida en la banda, si existe.
cxMinChild
Tipo: UINT
Ancho mínimo de la ventana secundaria, en píxeles. La banda no puede tener un tamaño menor que este valor.
cyMinChild
Tipo: UINT
Alto mínimo de la ventana secundaria, en píxeles. La banda no puede tener un tamaño menor que este valor.
cx
Tipo: UINT
Longitud de la banda, en píxeles.
hbmBack
Tipo: HBITMAP
Identificador de un mapa de bits que se usa como fondo para esta banda.
wID
Tipo: UINT
Valor UINT que el control usa para identificar esta banda para los mensajes de notificación de dibujo personalizados.
cyChild
Tipo: UINT
Versión 4.71. Alto inicial de la banda, en píxeles. Este miembro se omite a menos que se especifique el estilo RBBS_VARIABLEHEIGHT.
cyMaxChild
Tipo: UINT
Versión 4.71. Alto máximo de la banda, en píxeles. Este miembro se omite a menos que se especifique el estilo RBBS_VARIABLEHEIGHT.
cyIntegral
Tipo: UINT
Versión 4.71. Valor de paso por el que la banda puede crecer o reducirse, en píxeles. Si se cambia el tamaño de la banda, se cambiará de tamaño en los pasos especificados por este valor. Este miembro se omite a menos que se especifique el estilo RBBS_VARIABLEHEIGHT.
cxIdeal
Tipo: UINT
Versión 4.71. Ancho ideal de la banda, en píxeles. Si la banda está maximizada al ancho ideal (vea RB_MAXIMIZEBAND), el control de barra intentará convertir la banda en este ancho.
lParam
Tipo: LPARAM
Versión 4.71. Valor definido por la aplicación.
cxHeader
Tipo: UINT
Versión 4.71. Tamaño del encabezado de la banda, en píxeles. El encabezado de banda es el área entre el borde de la banda y el borde de la ventana secundaria. Este es el área donde se muestran el texto de banda y las imágenes, si se especifican. Si se especifica este valor, invalidará las dimensiones de encabezado normales que el control calcula para la banda.
rcChevronLocation
Tipo: RECT
Versión 6. Ubicación del botón de contenido adicional.
uChevronState
Tipo: UINT
Versión 6. Combinación de las constantes de estado de objeto.
Comentarios
Los miembros cxMinChild, cyMinChild y cx proporcionan información sobre las dimensiones relativas a la orientación del control. Es decir, para un control de barra horizontal, cxMinChild y cx son medidas horizontales y cyMinChild es una medida vertical. Sin embargo, si el control usa el estilo CCS_VERT , cxMinChild y cx son medidas verticales y cyMinChild es una medida horizontal.
Nota:
El encabezado commctrl.h define REBARBANDINFO 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
| Cliente mínimo compatible | Windows Vista [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Encabezado | commctrl.h |
Comentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de