Kelas CDockState

Kelas berseri CObject yang memuat, membongkar, atau menghapus status satu atau beberapa bilah kontrol docking dalam memori persisten (file).

Sintaks

class CDockState : public CObject

Anggota

Metode Publik

Anggota Data Publik

Keterangan

Status dermaga mencakup ukuran dan posisi bilah dan apakah itu ditampar atau tidak. Saat mengambil status dok tersimpan, CDockState memeriksa posisi bilah dan, jika bilah tidak terlihat dengan pengaturan layar saat ini, CDockState menskalakan posisi bilah sehingga terlihat. Tujuan utamanya CDockState adalah untuk menahan seluruh status sejumlah bilah kontrol dan untuk memungkinkan status tersebut disimpan dan dimuat baik ke registri, aplikasi . File INI, atau dalam bentuk biner sebagai bagian CArchive dari konten objek.

Bilah dapat berupa bilah kontrol yang dapat di-dok, termasuk bilah alat, bilah status, atau bilah dialog. CDockState objek ditulis dan dibaca ke atau dari file melalui CArchive objek.

CFrameWnd::GetDockState mengambil informasi status semua objek jendela CControlBar bingkai dan memasukkannya ke CDockState dalam objek. Anda kemudian dapat menulis konten CDockState objek ke penyimpanan dengan Serialize atau CDockState::SaveState. Jika nanti Anda ingin memulihkan status bilah kontrol di jendela bingkai, Anda dapat memuat status dengan Serialize atau CDockState::LoadState, lalu menggunakan CFrameWnd::SetDockState untuk menerapkan status tersimpan ke bilah kontrol jendela bingkai.

Untuk informasi selengkapnya tentang bilah kontrol docking, lihat artikel Bilah Kontrol, Bilah Alat: Docking dan Floating, dan Jendela Bingkai.

Hierarki Warisan

CObject

CDockState

Persyaratan

Header: afxadv.h

CDockState::Clear

Panggil fungsi ini untuk menghapus semua informasi docking yang CDockState disimpan dalam objek.

void Clear();

Keterangan

Ini tidak hanya mencakup apakah bilah ditampar atau tidak, tetapi ukuran dan posisi bilah dan apakah itu terlihat atau tidak.

CDockState::GetVersion

Panggil fungsi ini untuk mengambil nomor versi status bilah tersimpan.

DWORD GetVersion();

Tampilkan Nilai

1 jika informasi bilah tersimpan lebih lama dari status bilah saat ini; 2 jika informasi bilah tersimpan sama dengan status bilah saat ini.

Keterangan

Dukungan versi memungkinkan bilah yang direvisi untuk menambahkan properti persisten baru dan masih dapat mendeteksi dan memuat status persisten yang dibuat oleh versi bilah sebelumnya.

CDockState::LoadState

Panggil fungsi ini untuk mengambil informasi status dari registri atau . File INI.

void LoadState(LPCTSTR lpszProfileName);

Parameter

lpszProfileName
Menunjuk ke string null-terminated yang menentukan nama bagian dalam file inisialisasi atau kunci di registri Windows tempat informasi status disimpan.

Keterangan

Nama profil adalah bagian dari aplikasi . File INI atau registri yang berisi informasi status bilah. Anda dapat menyimpan informasi status bilah kontrol ke registri atau . File INI dengan SaveState.

CDockState::m_arrBarInfo

Objek CPtrArray yang merupakan array pointer ke informasi bilah kontrol tersimpan untuk setiap bilah kontrol yang telah menyimpan informasi status dalam CDockState objek.

CPtrArray m_arrBarInfo;

CDockState::SaveState

Panggil fungsi ini untuk menyimpan informasi status ke registri atau . File INI.

void SaveState(LPCTSTR lpszProfileName);

Parameter

lpszProfileName
Menunjuk ke string yang diteminasi null yang menentukan nama bagian dalam file inisialisasi atau kunci di registri Windows tempat informasi status disimpan.

Keterangan

Nama profil adalah bagian dari aplikasi . File INI atau registri yang berisi informasi status bilah kontrol. SaveState juga menyimpan ukuran layar saat ini. Anda dapat mengambil informasi bilah kontrol dari registri atau . File INI dengan LoadState.

Lihat juga

Kelas CObject
Bagan Hierarki