CDockState est une classe de CObject sérialisée qui charge, décharge ou efface l'état d'une ou plusieurs barres de contrôles d'amarrage en mémoire persistant (un fichier). L'État du quai inclut la taille et la position de la barre et si elle est ancrée. Récupérer la stockée quai État, CDockState vérifie la barre position et, si la barre n'est pas visible avec les paramètres actuels de l'écran, CDockState met la barre position afin qu'elle soit visible. L'objectif principal de CDockState est de tenir l'État tout entier d'un certain nombre de barres de contrôles et de permettre à cet état d'être sauvé et chargés soit dans le registre, l'application.Fichier INI, ou sous forme binaire dans le cadre du contenu d'un objet CArchive.
La barre peut être n'importe quel contrôle Ancrable bar, y compris une barre d'outils, la barre d'État ou la barre de boîte de dialogue. CDockState objets sont écrits et lire à partir d'un fichier via un objet CArchive.
CFrameWnd::GetDockState récupère les informations d'état des objets de la fenêtre frame CControlBar et il met dans l'objet CDockState . Vous pouvez ensuite écrire le contenu de l'objet CDockState de stockage avec Serialize ou CDockState::SaveState. Si vous voulez plus tard restaurer l'état des barres de contrôle dans la fenêtre frame, vous pouvez charger l'État avec Serialize ou CDockState::LoadState, puis utilisez CFrameWnd::SetDockState d'appliquer l'état enregistré aux barres de contrôles de la fenêtre frame.
Pour plus d'informations sur l'ancrage des barres de contrôles, consultez les articles Sujets de barre de contrôle, barres d'outils : amarrage et flottante, et Sujets de fenêtre Frame dans le Guide du programmeur Visual C++.
# include lt;afxadv.h>
Membres de la classe | ; Classe de base | Graphique de la hiérarchie