Compartir a través de

Estructura REBARBANDINFOA (commctrl.h)

  • Artículo

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

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
RBBIM_BACKGROUND
 El miembro hbmBack es válido o debe establecerse.
RBBIM_CHILD
 El miembro hwndChild es válido o debe establecerse.
RBBIM_CHILDSIZE
 Los miembros cxMinChild, cyMinChild, cyChild, cyMaxChild y cyIntegral son válidos o deben establecerse.
RBBIM_COLORS
 Los miembros clrFore y clrBack son válidos o deben establecerse.
RBBIM_HEADERSIZE

Versión 4.71. El miembro cxHeader es válido o debe establecerse.
RBBIM_IDEALSIZE

Versión 4.71. El miembro cxIdeal es válido o debe establecerse.
RBBIM_ID
 El miembro wID es válido o debe establecerse.
RBBIM_IMAGE
 El miembro iImage es válido o debe establecerse.
RBBIM_LPARAM

Versión 4.71. El miembro lParam es válido o debe establecerse.
RBBIM_SIZE
 El miembro cx es válido o debe establecerse.
RBBIM_STYLE
 El miembro fStyle es válido o debe establecerse.
RBBIM_TEXT
 El miembro lpText es válido o debe establecerse.
RBBIM_CHEVRONLOCATION
 El miembro rcChevronLocation es válido o debe establecerse.
RBBIM_CHEVRONSTATE
 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
RBBS_BREAK
 La banda está en una nueva línea.
RBBS_CHILDEDGE
 La banda tiene un borde en la parte superior e inferior de la ventana secundaria.
RBBS_FIXEDBMP
 El mapa de bits de fondo no se mueve cuando se cambia el tamaño de la banda.
RBBS_FIXEDSIZE
 No se puede ajustar el tamaño de la banda. Con este estilo, el agarre de tamaño no se muestra en la banda.
RBBS_GRIPPERALWAYS

Versión 4.71. La banda siempre tendrá un agarre de tamaño, incluso si es la única banda en la barra.
RBBS_HIDDEN
 La banda no estará visible.
RBBS_NOGRIPPER

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.
RBBS_USECHEVRON

Versión 5.80. Muestra un botón de contenido adicional si la banda es menor que cxIdeal.
RBBS_VARIABLEHEIGHT

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.
RBBS_NOVERT
 No se muestre cuando sea vertical.
RBBS_HIDETITLE
 Mantenga el título de banda oculto.
RBBS_TOPALIGN
 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

Altura mínima 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

Controle a 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 la barra de rebar 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 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 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en 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]
Encabezado commctrl.h