CSplitterWnd::Create

Article
03/04/2013

Pour créer une fenêtre fractionnée dynamique, appelez la fonction membre de Créer .

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

Paramètres

pParentWnd
La fenêtre frame parente de la fenêtre fractionnée.
nMaxRows
Le nombre maximal de lignes dans la fenêtre fractionnée.Cette valeur ne doit pas dépasser 2.
nMaxCols
Le nombre de colonnes de la fenêtre fractionnée.Cette valeur ne doit pas dépasser 2.
sizeMin
Spécifie la taille minimale à laquelle un volet peut être affiché.
pContext
Un pointeur vers une structure de CCreateContext .Dans la plupart des cas, il peut être pContext passé à la fenêtre frame parente.
dwStyle
Spécifie le style de fenêtre.
nID
L'ID de fenêtre enfant de la fenêtre.L'ID peut être AFX_IDW_PANE_FIRST à moins que la fenêtre fractionnée est imbriquée dans une autre fenêtre fractionnée.

Valeur de retour

Une valeur différente de zéro si l'opération a réussi ; sinon 0.

Notes

Vous pouvez incorporer CSplitterWnd dans un objet parent de CFrameWnd ou de CMDIChildWnd en prenant les étapes suivantes :

Incluez une variable membre d' CSplitterWnd dans le frame parent.
Substituez la fonction membre parent de CFrameWnd::OnCreateClient du frame.
Appelez la fonction membre de Créer d' OnCreateClientremplacé.

Lorsque vous créez une fenêtre fractionnée d'un frame parent, passez le paramètre parent d' pContext du frame à la fenêtre fractionnée.Sinon, ce paramètre peut être NULL.

La hauteur de ligne et la largeur de colonne minimale initiales d'une fenêtre fractionnée dynamique sont fixées par le paramètre d' sizeMin .Ces minimum, qui déterminent si un volet est trop petit pour être indiqué dans son intégralité, peuvent être modifiés avec les fonctions membres de SetRowInfo et de SetColumnInfo .

Pour plus d'informations sur les fenêtres fractionnées dynamiques, consultez « fenêtres fractionnées » dans l'article Plusieurs types de documents, des vues, et fenêtres frames, note technique 29, et la vue d'ensemble de la classe de CSplitterWnd .

Exemple

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