CSplitterWnd::Create

Artigo
06/10/2015

Para criar uma janela dinâmico do separador, chame a função de membro de Criar .

virtual BOOL Create( 
   CWnd* pParentWnd, 
   int nMaxRows, 
   int nMaxCols, 
   SIZE sizeMin, 
   CCreateContext* pContext, 
   DWORD dwStyle = WS_CHILD | WS_VISIBLE | WS_HSCROLL | WS_VSCROLL | SPLS_DYNAMIC_SPLIT, 
   UINT nID = AFX_IDW_PANE_FIRST  
);

Parâmetros

pParentWnd
A janela pai do quadro da janela separator.
nMaxRows
O número máximo de linhas na janela separator. Esse valor não pode exceder 2.
nMaxCols
O número de colunas máximo na janela separator. Esse valor não pode exceder 2.
sizeMin
Especifica o tamanho mínimo em um painel que pode ser exibido.
pContext
Um ponteiro a estrutura de CCreateContext . Em a maioria dos casos, isso pode ser pContext passado para a janela pai do quadro.
dwStyle
Especifica o estilo da janela.
nID
A identificação da janela filho da janela. A identificação pode ser AFX_IDW_PANE_FIRST a menos que a janela separator está aninhada em outra janela separator.

Valor de retorno

Diferente de zero se com êxito; se não 0.

Comentários

Você pode inserir CSplitterWnd em um objeto pai de CFrameWnd ou de CMDIChildWnd colocando 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.
Chame a função de membro de Criar de dentro de OnCreateClientsubstituído.

Quando você cria uma janela de separador de dentro de um elemento pai, passar o parâmetro pai de pContext do quadro para a janela do separador. Caso contrário, este parâmetro pode ser NULO.

A altura da linha e a largura da coluna mínimas inicial de uma janela dinâmico separator são definidas pelo parâmetro de sizeMin . Esses mínimo, que determina se um painel é muito pequeno ser mostrado em sua totalidade, podem ser alterados com as funções de membro de SetRowInfo e de SetColumnInfo .

Para mais no windows dinâmicos de separador, consulte “windows” separador no artigo Vários tipos de documento, modos de exibição, e janelas de quadro chave, Observe técnica 29, e a visão geral da classe de CSplitterWnd .

Exemplo

// the following function is created by the MFC Application Wizard  
// when you select Split window from the User Interface Features tab: 
BOOL CMyChildFrame::OnCreateClient(LPCREATESTRUCT /*lpcs*/, CCreateContext* pContext)
{
    return m_wndSplitter.Create(this,
        2, 2,       // TODO: adjust the number of rows, columns
        CSize(10, 10),  // TODO: adjust the minimum pane size
        pContext);
}