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

Publiczne elementy członkowskie danych

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

Obiekt CObject

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.

Zobacz też

Klasa CObject
Wykres hierarchii