CDockState-klasse

Opmerking

De Microsoft Foundation Classes-bibliotheek (MFC) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Een geserialiseerde CObject klasse waarmee een of meer dockingbesturingsbalken in permanent geheugen (een bestand) worden geladen, uitgeladen of gewist.

Syntaxis

class CDockState : public CObject

Leden

Openbare methoden

Naam	Description
CDockState::Clear	Hiermee wist u de statusinformatie van het dock.
CDockState::GetVersion	Hiermee wordt het versienummer van de opgeslagen staafstatus opgehaald.
CDockState::LoadState	Haalt statusinformatie op uit het register of . INI-bestand.
CDockState::SaveState	Hiermee worden statusgegevens opgeslagen in het register- of INI-bestand.

Leden van openbare gegevens

Naam	Description
CDockState::m_arrBarInfo	Matrix van aanwijzers naar de opgeslagen dockstatusgegevens met één vermelding voor elke besturingsbalk.

Opmerkingen

De dockstatus bevat de grootte en positie van de staaf en of deze al dan niet is gedokt. Bij het ophalen van de opgeslagen dockstatus controleert CDockState u de positie van de balk en als de balk niet zichtbaar is met de huidige scherminstellingen, CDockState schaalt u de positie van de balk zodanig dat deze zichtbaar is. Het belangrijkste doel is CDockState om de volledige status van een aantal besturingsbalken te bewaren en toe te staan dat die status wordt opgeslagen en geladen in het register, de toepassing. INI-bestand of in binaire vorm als onderdeel van de inhoud van een CArchive object.

De balk kan elke besturingselementbalk zijn die kan worden gekoppeld, met inbegrip van een werkbalk, statusbalk of dialoogvensterbalk. CDockState objecten worden geschreven en gelezen naar of van een bestand via een CArchive object.

CFrameWnd::GetDockState haalt de statusgegevens van alle objecten van het framevenster CControlBar op en plaatst deze in het CDockState object. Vervolgens kunt u de inhoud van het CDockState object naar opslag schrijven met Serialize of CDockState::SaveState. Als u later de status van de besturingsbalken in het framevenster wilt herstellen, kunt u de status laden met Serialize of CDockState::LoadState en vervolgens CFrameWnd::SetDockState gebruiken om de opgeslagen status toe te passen op de besturingsbalken van het framevenster.

Zie de artikelen Besturingsbalken, Werkbalken: Docking and Floating en Frame Windows voor meer informatie over het dokken van besturingsbalken.

Overnamehiërarchie

CObject

CDockState

Requirements

Koptekst: afxadv.h

CDockState::Clear

Roep deze functie aan om alle dockinginformatie die is opgeslagen in het CDockState object te wissen.

void Clear();

Opmerkingen

Dit omvat niet alleen of de balk is gedokt of niet, maar de grootte en positie van de balk en of deze wel of niet zichtbaar is.

CDockState::GetVersion

Roep deze functie aan om het versienummer van de opgeslagen staafstatus op te halen.

DWORD GetVersion();

Retourwaarde

1 als de opgeslagen balkgegevens ouder zijn dan de huidige staafstatus; 2 als de opgeslagen balkgegevens hetzelfde zijn als de huidige staafstatus.

Opmerkingen

Met versieondersteuning kan een herziene balk nieuwe permanente eigenschappen toevoegen en nog steeds de permanente status detecteren en laden die is gemaakt met een eerdere versie van de balk.

CDockState::LoadState

Roep deze functie aan om statusinformatie op te halen uit het register of . INI-bestand.

void LoadState(LPCTSTR lpszProfileName);

Parameterwaarden

lpszProfileName
Verwijst naar een door null beëindigde tekenreeks die de naam van een sectie in het initialisatiebestand of een sleutel in het Windows-register aangeeft waarin statusinformatie wordt opgeslagen.

Opmerkingen

De profielnaam is de sectie van de toepassing. INI-bestand of het register met de statusgegevens van de balken. U kunt informatie over de status van de besturingsbalk opslaan in het register of . INI-bestand met SaveState.

CDockState::m_arrBarInfo

Een CPtrArray object dat een matrix is van aanwijzers naar de opgeslagen besturingsbalkgegevens voor elke besturingsbalk die statusinformatie in het CDockState object heeft opgeslagen.

CPtrArray m_arrBarInfo;

CDockState::SaveState

Roep deze functie aan om de statusgegevens op te slaan in het register of . INI-bestand.

void SaveState(LPCTSTR lpszProfileName);

Parameterwaarden

lpszProfileName
Verwijst naar een tekenreeks met null-tekenreeks die de naam van een sectie in het initialisatiebestand of een sleutel in het Windows-register aangeeft waarin statusinformatie wordt opgeslagen.

Opmerkingen

De profielnaam is de sectie van de toepassing. INI-bestand of het register met de statusgegevens van de besturingsbalk. SaveState slaat ook de huidige schermgrootte op. U kunt informatie over de besturingsbalk ophalen uit het register of . INI-bestand met LoadState.

Zie ook

CObject-klasse
Hiërarchiegrafiek