CDockState osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

Egy szerializált CObject osztály, amely betölti, kiüríti vagy törli egy vagy több dokkoló vezérlősáv állapotát az állandó memóriában (egy fájlban).

Szemantika

class CDockState : public CObject

Tagok

Nyilvános metódusok

Név	Description
CDockState::Clear	Törli a dokkállapot adatait.
CDockState::GetVersion	Lekéri a tárolt sáv állapotának verziószámát.
CDockState::LoadState	Állapotinformációkat kér le a beállításjegyzékből vagy a . INI-fájl.
CDockState::SaveState	Állapotinformációkat ment a beállításjegyzékbe vagy az INI-fájlba.

Nyilvános adatok tagjai

Név	Description
CDockState::m_arrBarInfo	A tárolt dokkállapot-információkra mutató mutatótömb minden vezérlősávhoz egy bejegyzéssel.

Megjegyzések

A dokkolás állapota magában foglalja a sáv méretét és pozícióját, valamint azt, hogy rögzítve van-e. A tárolt dock állapotának CDockState beolvasásakor ellenőrizze a sáv helyzetét, és ha a sáv nem látható az aktuális képernyőbeállításokkal, CDockState skálázza a sáv pozícióját úgy, hogy látható legyen. A fő cél CDockState az, hogy tartsa a teljes állapotát számos vezérlősáv, és hogy lehetővé teszi, hogy az állapot menthető és betölthető a beállításjegyzékbe, az alkalmazás. INI-fájl, vagy bináris formában egy CArchive objektum tartalmának részeként.

A sáv bármilyen rögzíthető vezérlősáv lehet, beleértve az eszköztárat, az állapotsort vagy a párbeszédpanelt. CDockState az objektumok írása és olvasása egy fájlba vagy onnan egy CArchive objektumon keresztül.

CFrameWnd::GetDockState lekéri a keretablak CControlBar összes objektumának állapotadatait, és az objektumba helyezi.CDockState Ezután a Szerializálás vagy a CDockState::SaveState használatával megírhatja az CDockState objektum tartalmát a tárolóba. Ha később vissza szeretné állítani a keretablak vezérlősávjainak állapotát, betöltheti az állapotot Serialize a CDockState::LoadState használatával, majd a CFrameWnd::SetDockState használatával alkalmazhatja a mentett állapotot a keretablak vezérlősávjaira.

A dokkoló vezérlősávokkal kapcsolatos további információkért lásd a Vezérlősávok, eszköztárak: Dokkolás és lebegő, valamint a Keretablakok című témakört.

Öröklési hierarchia

CObject

CDockState

Requirements

Fejléc: afxadv.h

CDockState::Clear

Hívja meg ezt a függvényt az objektumban tárolt összes rögzítési információ törléséhez CDockState .

void Clear();

Megjegyzések

Ez nem csak azt foglalja magában, hogy a sáv rögzítve van-e vagy sem, hanem a sáv mérete és pozíciója, valamint az is, hogy látható-e.

CDockState::GetVersion

Hívja meg ezt a függvényt a tárolt sáv állapotának verziószámának lekéréséhez.

DWORD GetVersion();

Visszaadott érték

1, ha a tárolt sáv adatai régebbiek a jelenlegi sávállapotnál; 2, ha a tárolt sáv adatai megegyeznek az aktuális sáv állapotával.

Megjegyzések

A verziótámogatás lehetővé teszi, hogy a módosított sáv új állandó tulajdonságokat adjon hozzá, és továbbra is képes legyen észlelni és betölteni a sáv egy korábbi verziója által létrehozott állandó állapotot.

CDockState::LoadState

Hívja meg ezt a függvényt, hogy az állapotinformációkat lekérje a beállításjegyzékből vagy a . INI-fájl.

void LoadState(LPCTSTR lpszProfileName);

Paraméterek

lpszProfileName
Egy null értékű sztringre mutat, amely megadja az inicializálási fájl egy szakaszának nevét, vagy egy kulcsot a Windows beállításjegyzékében, ahol az állapotinformációk tárolása történik.

Megjegyzések

A profilnév az alkalmazás szakasza. INI-fájl vagy a sávok állapotadatait tartalmazó beállításjegyzék. A vezérlősáv állapotadatait mentheti a beállításjegyzékbe vagy a . INI-fájl a következővel SaveState: .

CDockState::m_arrBarInfo

Olyan CPtrArray objektum, amely a tárolt vezérlősáv-információkra mutató mutatótömb minden olyan vezérlősávhoz, amely az objektum állapotadatait CDockState mentette.

CPtrArray m_arrBarInfo;

CDockState::SaveState

Hívja meg ezt a függvényt, hogy mentse az állapotinformációkat a beállításjegyzékbe vagy . INI-fájl.

void SaveState(LPCTSTR lpszProfileName);

Paraméterek

lpszProfileName
Egy nullértékű sztringre mutat, amely megadja az inicializálási fájl egy szakaszának nevét, vagy egy kulcsot a Windows beállításjegyzékében, ahol az állapotinformációk tárolása történik.

Megjegyzések

A profilnév az alkalmazás szakasza. INI-fájl vagy a vezérlősáv állapotadatait tartalmazó beállításjegyzék. SaveState az aktuális képernyőméretet is menti. A vezérlősáv adatait lekérheti a beállításjegyzékből vagy a . INI-fájl a következővel LoadState: .

Lásd még

CObject osztály
hierarchiadiagram