Estrutura REBARBANDINFOA (commctrl.h)

Contém informações que definem uma banda em um controle de barra de barras.

Sintaxe

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;

Membros

cbSize

Tipo: UINT

Tamanho dessa estrutura, em bytes. Seu aplicativo deve preencher esse membro antes de enviar mensagens que usem o endereço dessa estrutura como parâmetro.

fMask

Tipo: UINT

Sinalizadores que indicam quais membros dessa estrutura são válidos ou devem ser preenchidos. Esse valor pode ser uma combinação do seguinte:

fStyle

Tipo: UINT

Sinalizadores que especificam o estilo de banda. Esse valor pode ser uma combinação do seguinte:

clrFore

Tipo: COLORREF

Cores de primeiro plano da banda.

clrBack

Tipo: COLORREF

Cores de tela de fundo de banda. Se hbmBack especificar um bitmap em segundo plano, esses membros serão ignorados. Por padrão, a banda usará a cor da tela de fundo do conjunto de controle de barras com a mensagem RB_SETBKCOLOR. Se uma cor de plano de fundo for especificada aqui, essa cor da tela de fundo será usada.

lpText

Tipo: LPTSTR

Ponteiro para um buffer que contém o texto de exibição da banda. Se as informações de banda estiverem sendo solicitadas do controle e RBBIM_TEXT for especificada no fMask, esse membro deverá ser inicializado para o endereço do buffer que receberá o texto.

cch

Tipo: UINT

Tamanho do buffer em lpText, em bytes. Se as informações não estiverem sendo solicitadas do controle, esse membro será ignorado.

iImage

Tipo: int

Índice baseado em zero de qualquer imagem que deve ser exibida na banda. A lista de imagens é definida usando a mensagem RB_SETBARINFO.

hwndChild

Tipo: HWND

Manipule para a janela filho contida na banda, se houver.

cxMinChild

Tipo: UINT

Largura mínima da janela filho, em pixels. A banda não pode ser dimensionada menor que esse valor.

cyMinChild

Tipo: UINT

Altura mínima da janela filho, em pixels. A banda não pode ser dimensionada menor que esse valor.

cx

Tipo: UINT

Comprimento da banda, em pixels.

hbmBack

Tipo: HBITMAP

Manipule para um bitmap usado como plano de fundo para essa banda.

wID

Tipo: UINT

Valor UINT que o controle usa para identificar essa banda para mensagens de notificação de desenho personalizadas.

cyChild

Tipo: UINT

versão 4.71. Altura inicial da banda, em pixels. Esse membro é ignorado, a menos que o estilo RBBS_VARIABLEHEIGHT seja especificado.

cyMaxChild

Tipo: UINT

versão 4.71. Altura máxima da banda, em pixels. Esse membro é ignorado, a menos que o estilo RBBS_VARIABLEHEIGHT seja especificado.

cyIntegral

Tipo: UINT

versão 4.71. Valor da etapa pelo qual a banda pode crescer ou reduzir, em pixels. Se a banda for redimensionada, ela será redimensionada em etapas especificadas por esse valor. Esse membro é ignorado, a menos que o estilo RBBS_VARIABLEHEIGHT seja especificado.

cxIdeal

Tipo: UINT

versão 4.71. Largura ideal da banda, em pixels. Se a banda for maximizada para a largura ideal (consulte RB_MAXIMIZEBAND), o controle de barras tentará tornar a banda essa largura.

lParam

Tipo: LPARAM

versão 4.71. Valor definido pelo aplicativo.

cxHeader

Tipo: UINT

versão 4.71. Tamanho do cabeçalho da banda, em pixels. O cabeçalho de banda é a área entre a borda da banda e a borda da janela filho. Essa é a área em que o texto e as imagens de banda são exibidos, se forem especificados. Se esse valor for especificado, ele substituirá as dimensões de cabeçalho normais que o controle calcula para a banda.

rcChevronLocation

Tipo: RECT

versão 6. Local da divisa.

uChevronState

Tipo: UINT

versão 6. Uma combinação das constantes de estado do objeto .

Observações

Os membros cxMinChild, cyMinChilde cx fornecem informações sobre dimensões relativas à orientação do controle. Ou seja, para um controle de barras horizontal, cxMinChild e cx são medidas horizontais e cyMinChild é uma medida vertical. No entanto, se o controle usar o estilo CCS_VERT, cxMinChild e cx são medidas verticais e cyMinChild é uma medida horizontal.

Requisitos