Estrutura REBARBANDINFOA (commctrl.h)
Contém informações que definem uma banda em um controle rebar.
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 qualquer mensagem que use 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:
| Valor | Significado |
|---|---|
|
O membro hbmBack é válido ou deve ser definido. |
|
O membro hwndChild é válido ou deve ser definido. |
|
Os membros cxMinChild, cyMinChild, cyChild, cyMaxChild e cyIntegral são válidos ou devem ser definidos. |
|
Os membros clrFore e clrBack são válidos ou devem ser definidos. |
|
Versão 4.71. O membro cxHeader é válido ou deve ser definido. |
|
Versão 4.71. O membro cxIdeal é válido ou deve ser definido. |
|
O membro wID é válido ou deve ser definido. |
|
O membro iImage é válido ou deve ser definido. |
|
Versão 4.71. O membro lParam é válido ou deve ser definido. |
|
O membro cx é válido ou deve ser definido. |
|
O membro fStyle é válido ou deve ser definido. |
|
O membro lpText é válido ou deve ser definido. |
|
O membro rcChevronLocation é válido ou deve ser definido. |
|
O membro uChevronState é válido ou deve ser definido. |
fStyle
Tipo: UINT
Sinalizadores que especificam o estilo de banda. Esse valor pode ser uma combinação do seguinte:
| Valor | Significado |
|---|---|
|
A banda está em uma nova linha. |
|
A banda tem uma borda na parte superior e inferior da janela filho. |
|
O bitmap em segundo plano não se move quando a banda é redimensionada. |
|
A banda não pode ser dimensionada. Com esse estilo, a alça de dimensionamento não é exibida na banda. |
|
Versão 4.71. A banda sempre terá um aperto de dimensionamento, mesmo que seja a única banda no rebar. |
|
A banda não ficará visível. |
|
Versão 4.71. A banda nunca terá um aperto de dimensionamento, mesmo que haja mais de uma banda no rebar. |
|
Versão 5.80. Mostre um botão de divisa se a banda for menor que cxIdeal. |
|
Versão 4.71. A banda pode ser redimensionada pelo controle rebar; cyIntegral e cyMaxChild afetam como o rebar redimensionará a banda. |
|
Não mostrar quando vertical. |
|
Mantenha o título da banda oculto. |
|
Mantenha a banda na linha superior. |
clrFore
Tipo: COLORREF
Cores de primeiro plano da banda.
clrBack
Tipo: COLORREF
Cores da tela de fundo da 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 rebar com a mensagem RB_SETBKCOLOR . Se uma cor da tela 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 especificado em 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
Identificador para a janela filho contida na faixa, 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 que é usado como o plano de fundo dessa banda.
wID
Tipo: UINT
Valor UINT que o controle usa para identificar essa faixa 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 de 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 rebar tentará tornar a banda dessa 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.
Comentários
Os membros cxMinChild, cyMinChild e cx fornecem informações sobre dimensões relativas à orientação do controle. Ou seja, para um controle de barra 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 serão medidas verticais e cyMinChild será uma medida horizontal.
Observação
O cabeçalho commctrl.h define REBARBANDINFO como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | commctrl.h |
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de