Sobre os controles de vergalhão

Um controlo de vergalhão atua como um contentor para janelas filhas. Ele pode conter uma ou mais bandas , e cada banda pode ter qualquer combinação de uma barra de fixação, um bitmap, um rótulo de texto e uma janela filha. Um aplicativo atribui uma janela filho — normalmente outro controle — a uma faixa de controle de rebar. À medida que reposiciona dinamicamente uma banda de vergalhão, o controle de vergalhão gere o tamanho e a posição da janela filha atribuída a essa banda. Além disso, um aplicativo pode especificar um bitmap de plano de fundo para uma faixa, e o controle de rebar exibirá a janela filha da faixa sobre o bitmap.

A captura de ecrã a seguir mostra um controlo de barras que tem duas faixas. Um contém uma barra de ferramentas e o outro contém uma caixa de combinação. Ambas as bandas têm um dispositivo de aperto que permite que sejam movidas e redimensionadas.

Bandas de Rebar e Janelas Filhas

Uma aplicação define as características de uma banda de vergalhões usando as mensagens RB_INSERTBAND e RB_SETBANDINFO. Essas mensagens aceitam o endereço de uma estrutura REBARBANDINFO como o parâmetro lParam. Os elementos da estrutura REBARBANDINFO definem as características de uma banda específica. Para definir as características de uma banda, defina o membro cbsize para indicar o tamanho da estrutura, em bytes. Depois, defina o membro fMask para indicar quais membros da estrutura a sua aplicação está a preencher.

Para atribuir uma janela filha a uma banda, inclua o sinalizador RBBIM_CHILD no membro fMask da estrutura REBARBANDINFO, e depois defina o membro hwndChild para o identificador da janela filha. As aplicações podem definir a largura e a altura mínimas permitidas de uma janela filha nos membros cxMinChild e cyMinChild.

Quando um controlo de barras de reforço é destruído, ele destrói quaisquer janelas filhas que estejam atribuídas às bandas dentro dele. Para evitar que o controle destrua janelas filhas atribuídas a suas bandas, remova as bandas enviando a mensagem RB_DELETEBAND e, em seguida, use a mensagem RB_SETPARENT para redefinir o pai para outra janela antes de destruir o controle de barras.

A interface de usuário do controle de vergalhão

Todas as bandas de controle do vergalhão podem ser redimensionadas, exceto aquelas que usam o estilo RBBS_FIXEDSIZE. Para redimensionar ou alterar a ordem das bandas dentro do controle, clique e arraste a barra de manipulação de uma banda. O controlo de barras redimensiona e reposiciona automaticamente as janelas filhas atribuídas às suas bandas. Além disso, podes alternar o tamanho de uma banda clicando no texto da banda, se houver.

A lista de imagens do Rebar Control

Se um aplicativo estiver a usar uma lista de imagens com um controlo de barra de ferramentas, deve enviar a mensagem RB_SETBARINFO antes de adicionar barras ao controlo. Esta mensagem aceita como parâmetro o endereço de uma estrutura REBARINFO , referenciada como lParam. Antes de enviar a mensagem, prepare a estrutura REBARINFO definindo o membro cbSize para o tamanho da estrutura, em bytes. Em seguida, se o controlador de vergalhão vai exibir imagens nas bandas, defina o membro fMask para o sinalizador RBIM_IMAGELIST e atribua um identificador de lista de imagens ao membro himl. Se a armadura não utilizar imagens de banda, defina fMask para zero.

Reencaminhamento de Mensagens de Controlo de Vergalhões

Um controlador de rebar encaminha todas as mensagens da janela WM_NOTIFY para a sua janela mãe. Além disso, um controle de barra de ferramentas encaminha todas as mensagens enviadas a ele a partir de janelas atribuídas a suas bandas, como WM_CHARTOITEM, WM_COMMANDe outras.