Klasa CDockState
Serializowana CObject klasa, która ładuje, zwalnia lub czyści stan co najmniej jednego paska kontrolki dokowania w pamięci trwałej (plik).
Składnia
class CDockState : public CObject
Elementy członkowskie
Metody publiczne
| Nazwa/nazwisko | opis |
|---|---|
| CDockState::Clear | Czyści informacje o stanie doku. |
| CDockState::GetVersion | Pobiera numer wersji przechowywanego stanu paska. |
| CDockState::LoadState | Pobiera informacje o stanie z rejestru lub . Plik INI. |
| CDockState::SaveState | Zapisuje informacje o stanie w rejestrze lub pliku INI. |
Publiczne elementy członkowskie danych
| Nazwa/nazwisko | opis |
|---|---|
| CDockState::m_arrBarInfo | Tablica wskaźników do przechowywanych informacji o stanie docku z jednym wpisem dla każdego paska sterowania. |
Uwagi
Stan docka obejmuje rozmiar i położenie słupka oraz to, czy jest zadokowany. Podczas pobierania przechowywanego stanu CDockState doku sprawdza położenie paska i, jeśli pasek nie jest widoczny z bieżącymi ustawieniami ekranu, CDockState skaluje położenie paska, aby był widoczny. Głównym celem CDockState programu jest utrzymywanie całego stanu wielu pasków kontrolnych i umożliwienie zapisania i załadowania tego stanu do rejestru, aplikacji . Plik INI lub w postaci binarnej CArchive w ramach zawartości obiektu.
Pasek może być dowolnym dokowalnym paskiem sterowania, w tym paskiem narzędzi, paskiem stanu lub paskiem okna dialogowego. CDockState obiekty są zapisywane i odczytywane do lub z pliku za pośrednictwem CArchive obiektu.
CFrameWnd::GetDockState pobiera informacje o stanie wszystkich obiektów okna CControlBar ramki i umieszcza je w CDockState obiekcie. Następnie możesz zapisać zawartość CDockState obiektu w magazynie za pomocą funkcji Serialize lub CDockState::SaveState. Jeśli później chcesz przywrócić stan pasków sterujących w oknie ramki, możesz załadować stan z Serialize lub CDockState::LoadState, a następnie użyć CFrameWnd::SetDockState , aby zastosować zapisany stan do pasków sterowania okna ramki.
Aby uzyskać więcej informacji na temat zadokowania pasków sterowania, zobacz artykuły Paski sterowania, Paski narzędzi: Docking and Floating i Frame Windows.
Hierarchia dziedziczenia
CDockState
Wymagania
Nagłówek: afxadv.h
CDockState::Clear
Wywołaj tę funkcję, aby wyczyścić wszystkie informacje o zadokowaniu przechowywane w CDockState obiekcie.
void Clear();
Uwagi
Obejmuje to nie tylko to, czy pasek jest zadokowany, czy nie, ale rozmiar i położenie paska oraz czy jest widoczny.
CDockState::GetVersion
Wywołaj tę funkcję, aby pobrać numer wersji przechowywanego stanu paska.
DWORD GetVersion();
Wartość zwracana
1, jeśli przechowywane informacje o pasku są starsze niż bieżący stan paska; 2, jeśli przechowywane informacje o pasku są takie same jak bieżący stan paska.
Uwagi
Obsługa wersji umożliwia poprawiony pasek dodawania nowych trwałych właściwości i nadal może wykrywać i ładować stan trwały utworzony przez wcześniejszą wersję paska.
CDockState::LoadState
Wywołaj tę funkcję, aby pobrać informacje o stanie z rejestru lub . Plik INI.
void LoadState(LPCTSTR lpszProfileName);
Parametry
lpszProfileName
Wskazuje ciąg o wartości null, który określa nazwę sekcji w pliku inicjowania lub klucz w rejestrze systemu Windows, w którym są przechowywane informacje o stanie.
Uwagi
Nazwa profilu to sekcja aplikacji . Plik INI lub rejestr zawierający informacje o stanie pasków. Informacje o stanie paska sterowania można zapisać w rejestrze lub . Plik INI z plikiem SaveState.
CDockState::m_arrBarInfo
CPtrArray Obiekt, który jest tablicą wskaźników do przechowywanych informacji paska sterowania dla każdego paska sterowania, który zapisał informacje o stanie w CDockState obiekcie.
CPtrArray m_arrBarInfo;
CDockState::SaveState
Wywołaj tę funkcję, aby zapisać informacje o stanie w rejestrze lub . Plik INI.
void SaveState(LPCTSTR lpszProfileName);
Parametry
lpszProfileName
Wskazuje ciąg o wartości null, który określa nazwę sekcji w pliku inicjowania lub klucz w rejestrze systemu Windows, w którym są przechowywane informacje o stanie.
Uwagi
Nazwa profilu to sekcja aplikacji . Plik INI lub rejestr zawierający informacje o stanie paska sterowania. SaveState Zapisuje również bieżący rozmiar ekranu. Informacje o pasku sterowania można pobrać z rejestru lub . Plik INI z plikiem LoadState.