Classe CSplitterWnd

Artigo
06/10/2015

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

class CSplitterWnd : public CWnd

Membros

Construtores public

Nome	Descrição
CSplitterWnd::CSplitterWnd	Chame para construir um objeto de CSplitterWnd .

Métodos públicos

Nome	Descrição
CSplitterWnd::ActivateNext	Executa o painel seguir ou o comando anterior do painel.
CSplitterWnd::CanActivateNext	Verifica se o painel seguir ou o comando anterior do painel são atualmente possível.
CSplitterWnd::Create	Chame para criar uma janela dinâmico do separador para e anexá-la ao objeto de CSplitterWnd .
CSplitterWnd::CreateScrollBarCtrl	Cria um controle compartilhado de barra de rolagem.
CSplitterWnd::CreateStatic	Chame para criar uma janela estática do separador para e anexá-la ao objeto de CSplitterWnd .
CSplitterWnd::CreateView	Chame para criar um painel em uma janela separator.
CSplitterWnd::DeleteColumn	Exclui uma coluna da janela separator.
CSplitterWnd::DeleteRow	Excluir uma linha de janela separator.
CSplitterWnd::DeleteView	Exclui uma exibição da janela separator.
CSplitterWnd::DoKeyboardSplit	Executa o comando split do teclado, geralmente “separação de janela.”
CSplitterWnd::DoScroll	Performs sincronizou rolagem de janelas de divisão.
CSplitterWnd::DoScrollBy	O rola racharam windows por um determinado número de pixels.
CSplitterWnd::GetActivePane	Determina o painel ativa de foco ou modo de exibição ativo do elemento.
CSplitterWnd::GetColumnCount	Retorna o número da coluna atual do painel.
CSplitterWnd::GetColumnInfo	Retorna informações na coluna especificada.
CSplitterWnd::GetPane	Retorna o painel na linha e coluna especificada.
CSplitterWnd::GetRowCount	Retorna o número da linha atual do painel.
CSplitterWnd::GetRowInfo	Retorna informações na linha especificada.
CSplitterWnd::GetScrollStyle	Retorna o estilo compartilhado de barra de rolagem.
CSplitterWnd::IdFromRowCol	Retorna a identificação da janela filho do painel na linha e coluna especificada.
CSplitterWnd::IsChildPane	Chame para determinar se a janela estiver em um painel filho em essa janela separator.
CSplitterWnd::IsTracking	Determina se a barra separator está sendo movida atualmente.
CSplitterWnd::RecalcLayout	Chame para redisplay a janela separator após definir o tamanho da linha ou coluna.
CSplitterWnd::SetActivePane	Define um painel para ser ativo do elemento.
CSplitterWnd::SetColumnInfo	Chame para definir informações da coluna especificada.
CSplitterWnd::SetRowInfo	Chame para definir informações da linha especificada.
CSplitterWnd::SetScrollStyle	Especifica o novo estilo de barra de rolagem para suporte compartilhado de barra de rolagem da janela separator.
CSplitterWnd::SplitColumn	Indica onde uma janela de quadro chave divide verticalmente.
CSplitterWnd::SplitRow	Indica onde uma janela de quadro chave divide horizontalmente.

Métodos protegidos

Nome	Descrição
CSplitterWnd::OnDraw	Chamado pela estrutura para desenhar a janela separator.
CSplitterWnd::OnDrawSplitter	Processa uma imagem de uma janela de divisão.
CSplitterWnd::OnInvertTracker	Processa a imagem de uma janela de divisão para ser o mesmo tamanho e a forma como a janela do quadro.

Comentários

Um painel é geralmente um objeto específico do aplicativo derivado de CView, mas pode ser qualquer objeto de CWnd que possui a identificação da janela filho apropriado

Um objeto de CSplitterWnd geralmente é inserido em um objeto pai de CFrameWnd ou de CMDIChildWnd . Crie um objeto de CSplitterWnd usando as seguintes etapas:

Inserir um variável de membro de CSplitterWnd do elemento pai.
Substitua a função de membro pai de CFrameWnd::OnCreateClient do quadro.
De dentro de OnCreateClientsubstituído, chame a função de membro de Criar ou de CreateStatic de CSplitterWnd.

Chame a função de membro de Criar para criar uma janela dinâmico separator. Uma janela dinâmico do separador é normalmente usado para criar e rolar um número de painéis individuais, ou exibições, do mesmo documento. a estrutura cria automaticamente um painel inicial para o separador; na estrutura, cria redimensiona, e libera os painéis adicionais enquanto o usuário funciona controles window separator.

Quando você chama Criar, você especifica uma altura e largura da coluna mínimas da linha que determina quando os painéis são muito pequenos ser exibidos inteiramente. Depois de você chamar Criar, você pode ajustar esses mínimos chamando as funções de membro de SetColumnInfo e de SetRowInfo .

Também use as funções de membro de SetColumnInfo e de SetRowInfo para definir uma largura “” ideal para uma coluna e altura “” ideal para uma linha. Quando a estrutura exibe uma janela de separador, exibe o primeiro quadro pai, na janela separator. A estrutura apresenta os painéis nas colunas e linhas de acordo com suas dimensões ideais, trabalhando superior esquerdo do canto inferior direito da área cliente da janela separator.

Todos os painéis em uma janela dinâmico separator deve ser a mesma classe. Os aplicativos familiares que suportam o windows dinâmicos separator incluem o Microsoft Word e Microsoft Excel.

Use a função de membro de CreateStatic para criar uma janela estático separator. O usuário pode alterar apenas o tamanho dos painéis em uma janela estática do separador, não o número ou ordem.

Você deve especificamente criar os painéis estáticos do separador quando você cria o separador estático. Certifique-se de que você criar todos os painéis antes que a função de membro pai de OnCreateClient do quadro, retorna ou estrutura não exibirá a janela corretamente.

A função de membro de CreateStatic inicializa automaticamente um separador estática com uma linha de altura e largura da coluna mínimas de 0. Depois de você chamar Criar, ajuste esses mínimos chamando as funções de membro de SetColumnInfo e de SetRowInfo . Também use SetColumnInfo e SetRowInfo depois de você chamar CreateStatic para indicar dimensões ideais desejadas de painel.

Os painéis individuais de um separador estático geralmente pertencem às classes diferentes. Para exemplos do windows estáticos do separador, consulte o editor de gráficos e o gerenciador de arquivos do windows.

Uma janela de separador suporta barras de rolagem especiais (independentemente das barras de rolagem que os painéis podem ter). Essas barras de rolagem são filhos do objeto de CSplitterWnd e são compartilhados com os painéis.

Você cria essas barras de rolagem especiais quando você cria a janela separator. Por exemplo, CSplitterWnd que tem uma linha, duas colunas, e estilo de WS_VSCROLL exibirão uma barra de rolagem vertical que é compartilhada por dois painéis. Quando o usuário move a barra de rolagem, as mensagens de WM_VSCROLL são enviadas para ambos os painéis. Quando os painéis definem a posição da barra de rolagem, a barra de rolagem compartilhado está definida.

Para obter mais informações sobre windows do separador, consulte: