Freigeben über


CDockState-Klasse

Eine Klasse, die CObject serialisierte lädt, nimmt entladen oder löscht den Zustand einer oder mehrerer Steuerleisten Andocken im persistenten Speicher (eine Datei).

class CDockState : public CObject

Mitglieder

Öffentliche Methoden

Name

Beschreibung

CDockState::Clear

Löscht die Dockzustandsinformationen.

CDockState::GetVersion

Ruft die Versionsnummer der gespeicherten Leistezustandes ab.

CDockState::LoadState

Ruft Zustandsinformationen aus der Registrierung oder der INI-Datei ab.

CDockState::SaveState

Speichert Zustandsinformationen zur Registrierung oder die INI-Datei.

Öffentliche Datenmember

Name

Beschreibung

CDockState::m_arrBarInfo

Array von Zeigern auf gespeicherte Dockzustandsinformationen mit einem Eintrag für jede Steuerleiste.

Hinweise

Der Dockzustand enthält die Größe und Position der Leiste und ob er angedockt ist. Wenn der gespeicherten Dockzustand CDockState überprüft, der die Position und abgerufen werden, wenn die Leiste nicht mit den aktuellen Bildschirmeinstellungen sichtbar ist, CDockState Leiste skaliert die Position der Leiste, damit sie sichtbar ist. Der Hauptzweck CDockState ist, den gesamten Zustand mehrerer Steuerleisten angehalten und gespeichert werden Zustand zu ermöglichen, diesen und hat entweder zur Registrierung, die INI-Datei der Anwendung oder in binärer Form als Teil des Inhalts eines CArchive-Objekts.

Die Leiste kann eine andockbare Symbolleisten, einschließlich eine Symbolleiste, eine Statusleiste oder eine Dialogleiste sein. CDockState-Objekte werden und Lesen zu oder von einer Datei zu einem CArchive-Objekt geschrieben.

CFrameWnd::GetDockState ruft die Zustandsinformationen CControlBar des gesamten Rahmenfensters Objekte und setzt sie in das CDockState-Objekt ab. Sie können den Inhalt des CDockState-Objekts in den Speicher mit Serialisieren Sie oder CDockState::SaveState schreiben. Wenn Sie später den Zustand der Steuerleisten im Rahmenfenster wiederherstellen möchten, können Sie den Zustand mit Serialize oder CDockState::LoadState laden, verwenden CFrameWnd::SetDockState, um den gespeicherten Zustand zu den Steuerleisten des Rahmenfensters anzuwenden.

Weitere Informationen zu andockbare Steuerleisten, finden Sie in Artikel Steuerleisten, Symbolleisten: Andock und unverankert und Rahmenfenster.

Vererbungshierarchie

CObject

CDockState

Anforderungen

Header: afxadv.h

Siehe auch

Referenz

CObject-Klasse

Hierarchiediagramm