CSplitterWnd::criar

Artigo
08/25/2010

Para criar uma janela separadora dinâmica, telefonar o Criarfunção de membro .

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 do divisor.
nMaxRows
O número máximo de linhas na janela separadora.Esse valor não deve exceder 2.
nMaxCols
O número máximo de colunas na janela separadora.Esse valor não deve exceder 2.
sizeMin
Especifica o dimensionar mínimo em que um painel pode ser exibido.
pContext
Um ponteiro para um CCreateContext estrutura.Na maioria dos casos, isso pode ser a pContext passado para a janela pai do quadro.
dwStyle
Especifica o estilo de janela.
nID
A ID de janela filho da janela.A ID pode ser AFX_IDW_PANE_FIRST, a menos que a janela separadora está aninhada dentro de outra janela separadora.

Valor de retorno

Diferente de zero se bem-sucedida; caso contrário, 0.

Comentários

Você pode incorporar um CSplitterWnd em um pai CFrameWnd or CMDIChildWnd objeto tomando as seguintes etapas:

Incorporar um CSplitterWnd variável de membro do quadro pai.
Substituir CFrameWnd::OnCreateClientfunção de membro .
Chamar o Criar a função de membro de dentro a substituição OnCreateClient.

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

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

Para obter mais informações sobre janelas divisor dinâmicos, consulte "Divisão Windows" no artigoVários tipos de documento, exibições e quadros Windows, Observação técnica 29, and the CSplitterWnd visão geral da classe.

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);
}