Compartilhar via


Classe CSplitterWnd

Fornece a funcionalidade de uma janela separadora, que é uma janela que contém vários painéis.

class CSplitterWnd : public CWnd

Comentários

Um painel geralmente é um objeto específico do aplicativo derivado de CView, mas pode ser qualquer CWndID do objeto com a janela filho apropriado.

A CSplitterWnd objeto geralmente é incorporado em um pai CFrameWnd or CMDIChildWnd objeto.Criar um CSplitterWnd objeto usando as seguintes etapas:

  1. Incorporar um CSplitterWnd variável de membro do quadro pai.

  2. Substituir CFrameWnd::OnCreateClientfunção de membro .

  3. De dentro a substituição OnCreateClient, telefonar o Criar or CreateStatic função de membro de CSplitterWnd.

telefonar the Criarfunção de membro para criar uma janela separadora dinâmica.Uma janela separadora dinâmica normalmente é usada para criar e role durante um número de painéis individuais ou modos de exibição, do mesmo documento.A estrutura automaticamente cria um painel inicial para o divisor; em seguida, a estrutura cria, redimensiona e descarta de painéis adicionais conforme o usuário opera controles da janela do divisor.

Quando você telefonar Criar, você especificar uma linha mínimo altura e a largura da coluna que determinam quando os painéis estão muito pequenos para ser totalmente exibido.Depois que você telefonar Criar, você pode ajustar essas mínimos telefonar ing o SetColumnInfo and SetRowInfo funções de membro.

Use também o SetColumnInfo e SetRowInfofunções de membro para conjunto uma largura para uma coluna "ideal" e "ideal" altura de uma linha. Quando a estrutura exibe uma janela separadora, primeiro ele exibe o quadro pai, em seguida, janela separadora.A estrutura, em seguida, apresenta os painéis em colunas e linhas de acordo com suas dimensões ideais, trabalhando a partir de canto superior esquerdo para o canto inferior direito da área de cliente da janela divisor.

Todos os painéis em uma janela separadora dinâmica devem ser da mesma classe.Aplicativos familiares que oferece suporte a janelas de divisor dinâmica incluem Microsoft palavra e o Microsoft Excel.

Use o CreateStatic função de membro para criar uma janela separadora estático. O usuário pode alterar apenas o dimensionar dos painéis em um divisor estático janela, não seu número ou ordem.

Especificamente, você deve criar painéis do todos os estático divisor ao criar divisor estático.Certifique-se de que criar todos os painéis antes OnCreateClient retornos de função de membro ou o será estrutura não exibir a janela corretamente.

The CreateStatic função de membro inicializa automaticamente um divisor estático com uma largura mínima de linha de altura e a coluna de 0. Depois que você telefonar Criar, ajustar essas mínimos telefonar ing o SetColumnInfo and SetRowInfo funções de membro.Também usar SetColumnInfo e SetRowInfo Depois de chamar CreateStatic para indicar as dimensões desejadas painel ideal.

Os painéis individuais de um divisor estático geralmente pertencem a diferentes classes.Para obter exemplos de janelas de divisor estático, consulte o editor de elementos gráficos e o Gerenciador de arquivos do Windows.

Uma janela separadora oferece suporte a barras de rolar especiais (além de barras de rolar podem ter painéis).Essas barras de rolar são filhos do CSplitterWnd objeto e são compartilhadas com os painéis.

Você pode criar essas barras de rolar especial ao criar janela separadora.Por exemplo, um CSplitterWnd que tem uma linha, duas colunas e o WS_VSCROLL estilo exibirá uma vertical BAR de rolar que é compartilhado por dois painéis.Quando o usuário move o BAR de rolar, WM_VSCROLL as mensagens são enviadas para os dois painéis. Quando os painéis de conjunto a posição da BAR de rolar, a BAR de rolar compartilhado é definida.

Para obter mais informações sobre as janelas de divisor, consulte:

  • Observação técnica 29

  • Artigo da Base de dados de Conhecimento Q262024: HOWTO: Usar CPropertySheet sistema autônomo um filho do CSplitterWnd

Para obter mais informações sobre como criar janelas divisor dinâmicos, consulte:

Requisitos

Cabeçalho: afxext.h

Consulte também

Tarefas

Exemplo VIEWEX: Demonstra Múltiplo modos de exibição, modos de exibição de rolagem e divisão Windows

Referência

Classe CWnd

Gráfico de hierarquia

Classe CView

Classe CWnd

Outros recursos

CSplitterWnd membros