CDockState 클래스

영구 메모리(파일)에서 하나 이상의 도킹 컨트롤 막대의 상태를 로드, 언로드 또는 지우는 serialize된 CObject 클래스입니다.

구문

class CDockState : public CObject

멤버

공용 메서드

이름	설명
CDockState::Clear	도크 상태 정보를 지웁니다.
CDockState::GetVersion	저장된 막대 상태의 버전 번호를 검색합니다.
CDockState::LoadState	레지스트리 또는 .에서 상태 정보를 검색합니다. INI 파일.
CDockState::SaveState	레지스트리 또는 INI 파일에 상태 정보를 저장합니다.

공용 데이터 멤버

이름	설명
CDockState::m_arrBarInfo	각 컨트롤 막대에 대해 하나의 항목이 있는 저장된 도크 상태 정보에 대한 포인터 배열입니다.

설명

도크 상태에는 막대의 크기와 위치 및 도킹 여부가 포함됩니다. 저장된 도크 상태를 CDockState 검색할 때 막대의 위치를 검사 현재 화면 설정 CDockState 으로 막대가 표시되지 않으면 표시되도록 막대의 위치를 조정합니다. 기본 목적은 CDockState 여러 컨트롤 막대의 전체 상태를 유지하고 해당 상태를 애플리케이션의 레지스트리에 저장하고 로드할 수 있도록 하는 것입니다. INI 파일 또는 개체 내용의 CArchive 일부로 이진 형식입니다.

막대는 도구 모음, 상태 막대 또는 대화 상자 표시줄을 포함하여 도킹 가능한 컨트롤 막대일 수 있습니다. CDockState 개체는 개체를 통해 파일을 쓰고 파일에서 읽습니다 CArchive .

CFrameWnd::GetDockState 는 모든 프레임 창 개체의 CControlBar 상태 정보를 검색하여 개체에 CDockState 넣습니다. 그런 다음 Serialize 또는 CDockState::SaveState를 사용하여 개체의 CDockState 내용을 스토리지에 쓸 수 있습니다. 나중에 프레임 창에서 컨트롤 막대의 상태를 복원하려면 CDockState::LoadState를 Serialize 사용하여 상태를 로드한 다음, CFrameWnd::SetDockState를 사용하여 저장된 상태를 프레임 창의 컨트롤 막대에 적용할 수 있습니다.

컨트롤 막대 도킹에 대한 자세한 내용은 컨트롤 막대, 도구 모음: 도킹 및 부동 및 프레임 창 문서를 참조하세요.

상속 계층 구조

CObject

CDockState

요구 사항

헤더: afxadv.h

CDockState::Clear

개체에 저장된 모든 도킹 정보를 지우려면 이 함수를 CDockState 호출합니다.

void Clear();

설명

여기에는 막대가 도킹되었는지 여부뿐만 아니라 막대의 크기와 위치 및 표시 여부도 포함됩니다.

CDockState::GetVersion

이 함수를 호출하여 저장된 막대 상태의 버전 번호를 검색합니다.

DWORD GetVersion();

Return Value

저장된 막대 정보가 현재 막대 상태보다 오래된 경우 1입니다. 저장된 막대 정보가 현재 막대 상태와 같으면 2입니다.

설명

버전 지원을 사용하면 수정된 막대에서 새 영구 속성을 추가할 수 있으며 이전 버전의 막대에서 만든 영구 상태를 검색하고 로드할 수 있습니다.

CDockState::LoadState

레지스트리 또는 .에서 상태 정보를 검색하려면 이 함수를 호출합니다. INI 파일.

void LoadState(LPCTSTR lpszProfileName);

매개 변수

lpszProfileName
초기화 파일의 섹션 이름 또는 상태 정보가 저장되는 Windows 레지스트리의 키를 지정하는 null로 끝나는 문자열을 가리킵니다.

설명

프로필 이름은 애플리케이션의 섹션입니다. INI 파일 또는 막대의 상태 정보가 포함된 레지스트리입니다. 레지스트리 또는 .에 컨트롤 막대 상태 정보를 저장할 수 있습니다. 를 사용한 SaveStateINI 파일

CDockState::m_arrBarInfo

CPtrArray 개체에 상태 정보를 CDockState 저장한 각 컨트롤 막대의 저장된 컨트롤 막대 정보에 대한 포인터 배열인 개체입니다.

CPtrArray m_arrBarInfo;

CDockState::SaveState

이 함수를 호출하여 레지스트리 또는 에 상태 정보를 저장합니다. INI 파일.

void SaveState(LPCTSTR lpszProfileName);

매개 변수

lpszProfileName
초기화 파일의 섹션 이름 또는 상태 정보가 저장되는 Windows 레지스트리의 키를 지정하는 null로 구분된 문자열을 가리킵니다.

설명

프로필 이름은 애플리케이션의 섹션입니다. INI 파일 또는 컨트롤 바의 상태 정보를 포함하는 레지스트리입니다. SaveState 또한 현재 화면 크기를 저장합니다. 레지스트리 또는 .에서 컨트롤 바 정보를 검색할 수 있습니다. 를 사용한 LoadStateINI 파일

참고 항목

CObject 클래스
계층 구조 차트