Estructura REBARBANDINFOA (commctrl.h)
Contiene información que define una banda en un control rebar.
Sintaxis
typedef struct tagREBARBANDINFOA {
UINT cbSize;
UINT fMask;
UINT fStyle;
COLORREF clrFore;
COLORREF clrBack;
LPSTR 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;
} REBARBANDINFOA, *LPREBARBANDINFOA;
Miembros
cbSize
Tipo: UINT de
Tamaño de esta estructura, en bytes. La aplicación debe rellenar este miembro antes de enviar los mensajes que usen la dirección de esta estructura como parámetro.
fMask
Tipo: UINT de
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 |
|
El miembro hwndChild es válido o debe establecerse. |
|
El cxMinChild, cyMinChild, cyChild, cyMaxChildy miembros cyIntegral son válidos o deben establecerse. |
|
Los clrFore y miembros clrBack son válidos o deben establecerse. |
|
versión 4.71. El miembro |
|
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 |
|
El miembro cx |
|
El miembro fStyle es válido o debe establecerse. |
|
El miembro lpText es válido o debe establecerse. |
|
El miembro |
|
El miembro |
fStyle
Tipo: UINT de
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. |
|
Versión 5.80. Muestra un botón de contenido adicional si la banda es menor que cxIdeal. |
|
versión 4.71. El control rebar 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 oculto el título de la banda. |
|
Mantenga la banda en la fila superior. |
clrFore
Colores de primer plano de banda.
clrBack
Colores de fondo de banda. Si hbmBack especifica un mapa de bits en segundo plano, 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, este color de fondo se usará en su lugar.
lpText
Tipo: LPTSTR de
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 de
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 mediante el mensaje RB_SETBARINFO.
hwndChild
Controla la ventana secundaria contenida en la banda, si existe.
cxMinChild
Tipo: UINT de
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 de
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 de
Longitud de la banda, en píxeles.
hbmBack
Tipo: HBITMAP de
Controla un mapa de bits que se usa como fondo para esta banda.
wID
Tipo: UINT de
Valor UINT que usa el control para identificar esta banda para los mensajes de notificación de dibujo personalizados.
cyChild
Tipo: UINT de
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 de
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 de
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 de
versión 4.71. Ancho ideal de la banda, en píxeles. Si la banda está maximizada hasta el ancho ideal (vea RB_MAXIMIZEBAND), el control rebar intentará convertir la banda en este ancho.
lParam
Tipo: LPARAM de
versión 4.71. Valor definido por la aplicación.
cxHeader
Tipo: UINT de
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
versión 6. Ubicación del botón de contenido adicional.
uChevronState
Tipo: UINT de
versión 6. Combinación de las constantes de estado de objeto .
Observaciones
Los miembros de cxMinChild, cyMinChildy cx proporcionan información sobre las dimensiones relativas a la orientación del control. Es decir, para un control de barra de rebar 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 Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows Vista [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| encabezado de |
commctrl.h |