Dienste

Artikel
02/26/2013

Um ein dynamisches Splitterfenster zu erstellen, rufen Sie die Create-Memberfunktion auf.

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

Parameter

pParentWnd
Das übergeordnete Rahmenfenster des Splitterfensters.
nMaxRows
Die maximale Anzahl von Zeilen im Splitterfenster.Dieser Wert darf 2. nicht überschreiten.
nMaxCols
Die maximale Anzahl von Spalten im Splitterfenster.Dieser Wert darf 2. nicht überschreiten.
sizeMin
Gibt die minimale Größe an, mit der ein Bereich möglicherweise angezeigt wird.
pContext
Ein Zeiger auf eine Struktur CCreateContext.In den meisten Fällen kann dieses pContext sein, das auf das übergeordnete Rahmenfenster übergeben wird.
dwStyle
Gibt den Fensterstil an.
nID
Die ID des untergeordneten Fensters des Fensters.Die ID kann AFX_IDW_PANE_FIRST sein, es sei denn, das Splitterfenster innerhalb eines anderen Splitterfensters geschachtelt ist.

Rückgabewert

Ungleich 0 (null), wenn erfolgreich; 0 andernfalls.

Hinweise

Sie können CSplitterWnd in einem übergeordneten CFrameWnd oder CMDIChildWnd-Objekt einbetten, indem Sie die folgenden Schritte ausführen:

Betten Sie eine CSplitterWnd-Membervariable in übergeordneten Frames ein.
Überschreiben Sie die Elemente CFrameWnd::OnCreateClient-Memberfunktion der Rahmen.
Rufen Sie die Create-Memberfunktion aus überschriebenen OnCreateClient auf.

Wenn Sie ein Splitterfenster aus Elementen Frame erstellen, führen Sie den übergeordneten pContext-Parameter der Rahmen um Splitterfenster.Andernfalls kann dieser Parameter NULL sein.

Die ursprüngliche minimale Zeilenhöhe und die Spaltenbreite eines dynamischen Splitterfensters werden durch den sizeMin-Parameter festgelegt.Diese Minima, die bestimmen, ob ein Bereich zu klein ist, komplett angezeigt werden, können mit den SetRowInfo und SetColumnInfo-Memberfunktionen geändert werden.

Weitere Informationen zum dynamischen Splitterfenstern, finden Sie unter "Splitterfenster" im Artikel Mehrere Dokumenttypen, Ansichten und Rahmenfenster, Technischer Hinweis 29 und die CSplitterWnd-Klassenübersicht.

Beispiel

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