CSplitterWnd::Create

Articolo
02/19/2013

Per creare una finestra del separatore dinamico, chiamare la funzione membro Crea.

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

Parametri

pParentWnd
La finestra cornice padre della finestra con separatore.
nMaxRows
Numero massimo di righe nella finestra con separatore.Questo valore non deve superare 2.
nMaxCols
Numero massimo di colonne nella finestra con separatore.Questo valore non deve superare 2.
sizeMin
Specifica la dimensione minima di un riquadro può essere visualizzato.
pContext
Un puntatore a una struttura CCreateContext.Nella maggior parte dei casi, può essere pContext passato alla finestra cornice padre.
dwStyle
Specifica lo stile della finestra.
nID
La finestra figlio ID della finestra.L'id può essere AFX_IDW_PANE_FIRST a meno che la finestra con separatore è annidata in un'altra finestra con separatore.

Valore restituito

Diverso da zero se ha esito positivo; in caso contrario 0.

Note

È possibile incorporare CSplitterWnd in un oggetto padre CMDIChildWnd o CFrameWnd assumendo le seguenti azioni:

Importare una variabile membro CSplitterWnd nel frame padre.
Eseguire l'override della funzione membro padre CFrameWnd::OnCreateClient frame.
Chiamare la funzione membro Crea da OnCreateClientignorata.

Quando si crea una finestra con separatore da un frame padre, passare il parametro padre pContext frame alla finestra con separatore.In caso contrario, questo parametro può essere NULL.

L'altezza della riga e la larghezza della colonna minima iniziali di una finestra del separatore dinamico sono impostate dal parametro sizeMin.Questi minimi, che determinano se un riquadro è troppo piccolo essere visualizzato nella completezza, possono essere modificati con funzioni membro SetColumnInfo e SetRowInfo.

Per ulteriori informazioni sulle finestre di separazione dinamico, vedere "finestre con separatore" nell'articolo Tipi di documenti multipli, visualizzazioni e applicazioni utilizzano, nota tecnica 29e i cenni preliminari sulla classe CSplitterWnd.

Esempio

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