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
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();
Návratová 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.