CCreateContext

CCreateContext n'a pas une classe de base.

Le framework utilise la structure de CCreateContext lorsqu'il crée les fenêtres frames et les vues associées à un document. Lors de la création d'une fenêtre, les valeurs de cette structure fournissent des informations permettre de connecter les éléments qui composent un document et la vue de ses données. Vous devez uniquement utiliser CCreateContext si vous substituez parties du processus de création.

Une structure de CCreateContext contient des pointeurs vers le document, la fenêtre frame, la vue et le modèle de document. Il contient également un pointeur vers un CRuntimeClass qui identifie le type d'affichage à créer. Les informations de classe du moment de l'exécution et le pointeur courant de document sont utilisés pour créer un nouvel affichage dynamique. Le tableau suivant indique quand et comment chaque membre CCreateContext peut-être être utilisé:

Membres	Ce que c'est pour
m_pNewViewClass	CRuntimeClass de la nouvelle vue pour créer.
m_pCurrentDoc	Le document existant d'être associé à la nouvelle vue.
m_pNewDocTemplate	Le modèle de document associé à la création d'une nouvelle fenêtre de frame MDI.
m_pLastView	Le point de vue original sur lequel sont modélisés vues supplémentaires, comme dans la création de vues de la fenêtre d'un séparateur ou la création d'un deuxième avis sur un document.
m_pCurrentFrame	La fenêtre frame qui sont modélisés fenêtres frames supplémentaires, comme dans la création d'une deuxième fenêtre frame sur un document.

Lorsqu'un modèle de document crée un document et ses composants associés, il valide les informations stockées dans la structure CCreateContext . Par exemple, un point de vue ne doit pas être créée pour un document inexistant.

&Notenbsp ; Tous les pointeurs CCreateContext sont facultatifs et peuvent être NULL si non spécifié ou inconnu.

CCreateContext est utilisé par les fonctions membres énumérées sous "Voir aussi". Consulter les descriptions de ces fonctions pour plus d'informations, si vous prévoyez de les substituer.

Voici quelques lignes directrices générales:

Quand le passé comme argument pour la création de la fenêtre, comme dans CWnd::Create, CFrameWnd::Createet CFrameWnd::LoadFrame, le contexte de création spécifie ce que la nouvelle fenêtre doit être connectée à. Pour la plupart des fenêtres, la structure entière est facultative et un pointeur NULL peut être passé.
Pour les fonctions membres overridable, tels que CFrameWnd::OnCreateClient, l'argument CCreateContext est facultatif.
Pour les fonctions de membre impliquées en vue création, vous devez fournir suffisamment d'informations pour créer la vue. Par exemple, pour la première vue dans une fenêtre fractionnée, vous devez fournir les informations de classe du point de vue et le document en cours.

En général, si vous utilisez les paramètres par défaut de cadre, vous pouvez ignorer CCreateContext. Si vous essayez des modifications plus avancées, le code source de bibliothèque Microsoft Foundation Class ou exemples de programmes, comme par exemple VIEWEX, vous guidera. Si vous oubliez un paramètre requis, une affirmation du cadre vous dira ce que vous avez oublié.

Pour plus d'informations sur CCreateContext, consultez l'exemple MFC VIEWEX.

# include lt;afxext.h>

Graphique de la hiérarchie

Voir aussi ;CFrameWnd::Create, CFrameWnd::LoadFrame, CFrameWnd::OnCreateClient, CSplitterWnd::Create, CSplitterWnd::CreateView, CWnd::Create

Index