CDockState – třída

Serializovaná CObject třída, která načte, uvolní nebo vymaže stav jednoho nebo více dokovacích řídicích pruhů v trvalé paměti (soubor).

Syntaxe

class CDockState : public CObject

Členové

Veřejné metody

Název	Popis
CDockState::Clear	Vymaže informace o stavu docku.
CDockState::GetVersion	Načte číslo verze uloženého stavu pruhu.
CDockState::LoadState	Načte informace o stavu z registru nebo . SOUBOR INI.
CDockState::SaveState	Uloží informace o stavu do registru nebo souboru INI.

Veřejné datové členy

Název	Popis
CDockState::m_arrBarInfo	Poleukazatelůch

Poznámky

Stav ukotvení zahrnuje velikost a umístění pruhu a zda je ukotvený. Při načítání uloženého stavu CDockState docku zkontroluje umístění pruhu a pokud není pruh viditelný s aktuálním nastavením obrazovky, CDockState zvětšuje jeho polohu tak, aby byl viditelný. Hlavním účelem CDockState je uchovávat celý stav řady řídicích pruhů a umožnit, aby tento stav byl uložen a načten do registru, aplikace . Soubor INI nebo binární forma jako součást CArchive obsahu objektu.

Panel může být libovolný dokovatelný ovládací panel, včetně panelu nástrojů, stavového řádku nebo dialogového okna. CDockState objekty se zapisují a čtou do nebo ze souboru prostřednictvím objektu CArchive .

CFrameWnd::GetDockState načte informace o stavu všech objektů okna rámečku CControlBar a umístí je do objektu CDockState . Potom můžete napsat obsah objektu CDockState do úložiště pomocí Serialize nebo CDockState::SaveState. Pokud později chcete obnovit stav řídicích pruhů v okně rámce, můžete stav načíst pomocí Serialize nebo CDockState::LoadState a pak pomocí CFrameWnd::SetDockState použít uložený stav na řídicí panely okna rámce.

Další informace o ukotvení ovládacích pruhů naleznete v článcích Ovládací panely, panely nástrojů: Ukotvení a Plovoucí a Rámečková okna.

Hierarchie dědičnosti

Objekt CObject

CDockState

Požadavky

Hlavička: afxadv.h

CDockState::Clear

Voláním této funkce vymažete všechny dokovací informace uložené v objektu CDockState .

void Clear();

Poznámky

To zahrnuje nejen to, jestli je pruh ukotvený, nebo ne, ale velikost a umístění pruhu a to, jestli je nebo není viditelný.

CDockState::GetVersion

Voláním této funkce načtěte číslo verze uloženého stavu pruhu.

DWORD GetVersion();

Vrácená hodnota

1, pokud informace o uloženém pruhu jsou starší než aktuální stav pruhu; 2, pokud jsou uložené informace pruhu stejné jako aktuální stav pruhu.

Poznámky

Podpora verzí umožňuje revidované pruhy přidávat nové trvalé vlastnosti a stále dokáže rozpoznat a načíst trvalý stav vytvořený starší verzí pruhu.

CDockState::LoadState

Voláním této funkce načtěte informace o stavu z registru nebo . SOUBOR INI.

void LoadState(LPCTSTR lpszProfileName);

Parametry

lpszProfileName
Odkazuje na řetězec ukončený hodnotou null, který určuje název oddílu v inicializačním souboru nebo klíč v registru Systému Windows, kde jsou uloženy informace o stavu.

Poznámky

Název profilu je oddíl aplikace . Soubor INI nebo registr, který obsahuje informace o stavu pruhů. Informace o stavu řídicího panelu můžete uložit do registru nebo . INI soubor s SaveState.

CDockState::m_arrBarInfo

Objekt CPtrArray , který je polem ukazatelů na uložené informace řídicího panelu pro každý řídicí panel, který obsahuje uložené informace o stavu v objektu CDockState .

CPtrArray m_arrBarInfo;

CDockState::SaveState

Voláním této funkce uložíte informace o stavu do registru nebo . SOUBOR INI.

void SaveState(LPCTSTR lpszProfileName);

Parametry

lpszProfileName
Odkazuje na teminated řetězec s hodnotou null, který určuje název oddílu v inicializačním souboru nebo klíč v registru Systému Windows, kde jsou uloženy informace o stavu.

Poznámky

Název profilu je oddíl aplikace . Soubor INI nebo registr, který obsahuje informace o stavu řídicího panelu. SaveState také uloží aktuální velikost obrazovky. Informace řídicího panelu můžete načíst z registru nebo . INI soubor s LoadState.

Viz také

CObject – třída
Graf hierarchie