Partager via


CDockState, classe

Une classe sérialisée d' CObject qui charge, décharge, ou désactive l'état d'un ou plusieurs barres de contrôles d'ancrage en mémoire persistant (fichier).

class CDockState : public CObject

Membres

Méthodes publiques

Nom

Description

CDockState::Clear

Efface les informations d'état d'ancrage.

CDockState::GetVersion

Récupère le numéro de version de l'état stocké de barre.

CDockState::LoadState

Récupère les informations d'état du Registre ou le fichier .ini.

CDockState::SaveState

Enregistre les informations d'état au Registre ou au fichier INI.

Données membres publiques

Nom

Description

CDockState::m_arrBarInfo

Tableau de pointeurs vers des informations d'état stockées d'ancrage avec une entrée pour chaque barre de contrôles.

Notes

L'état d'ancrage inclut la taille et la position de la barre et si elle est ancrée. En récupérant l'état stocké d'ancrage, CDockState contrôle la position et, si la barre n'est pas visible avec les paramètres actuels d'écran, CDockState de la barre mesure la position de la barre de sorte qu'elle soit visible. L'objectif principal d' CDockState est de stocker l'état entier de plusieurs barres de contrôles et de permettre ce rapport à l'enregistrement et le chargement au Registre, le fichier .ini de l'application, ou sous forme binaire dans le cadre de le contenu d'un objet d' CArchive .

La barre peut être une barre de contrôles ancrable, y compris une barre d'outils, une barre d'état, ou une barre de boîte de dialogue. Les objets d'CDockState sont écrits et lisent à partir d'un fichier via un objet d' CArchive .

CFrameWnd::GetDockState extrait les informations d'état d' CControlBar de l'ensemble de la fenêtre frame l'objet et place dans l'objet de CDockState . Vous pouvez ensuite écrire le contenu de l'objet d' CDockState à la mémoire avec sérialisez ou CDockState::SaveState. Si vous souhaitez ultérieurement restaurer l'état des barres de contrôles dans la fenêtre frame, vous pouvez charger l'état et Serialize ou CDockState::LoadState, puis utilisez CFrameWnd::SetDockState pour 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 barres de contrôles, barres d'outils : L'ancrage et flottant, et fenêtres frames.

Hiérarchie d'héritage

CObject

CDockState

Configuration requise

Header: afxadv.h

Voir aussi

Référence

CObject, classe

Graphique de la hiérarchie