CDockState Sınıfı
Kalıcı bellekte (dosya) bir veya daha fazla yerleştirme denetim çubuğunun durumunu yükleyen, kaldıran veya temizleyen serileştirilmiş CObject bir sınıf.
Sözdizimi
class CDockState : public CObject
Üyeler
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| CDockState::Clear | Dock durumu bilgilerini temizler. |
| CDockState::GetVersion | Depolanan çubuk durumunun sürüm numarasını alır. |
| CDockState::LoadState | Kayıt defterinden veya konumundan durum bilgilerini alır. INI dosyası. |
| CDockState::SaveState | Durum bilgilerini kayıt defterine veya INI dosyasına kaydeder. |
Ortak Veri Üyeleri
| Veri Akışı Adı | Açıklama |
|---|---|
| CDockState::m_arrBarInfo | Her denetim çubuğu için bir giriş içeren depolanmış dock durumu bilgilerine yönelik işaretçi dizisi. |
Açıklamalar
Dock durumu, çubuğun boyutunu ve konumunu ve yerleşik olup olmadığını içerir. Depolanan takma birimi durumunu alırken çubuğun CDockState konumunu denetler ve çubuğun geçerli ekran ayarlarıyla görünür olmaması durumunda çubuğun CDockState konumunu görünür olacak şekilde ölçeklendirir. Ana amacı CDockState , bir dizi denetim çubuğu durumunun tamamını tutmak ve bu durumun uygulamanın kayıt defterine kaydedilmesine ve yüklenmesine izin vermektir. INI dosyası veya nesnenin içeriğinin bir CArchive parçası olarak ikili biçimde.
Çubuk, araç çubuğu, durum çubuğu veya iletişim kutusu çubuğu da dahil olmak üzere herhangi bir yerleşik denetim çubuğu olabilir. CDockState nesneleri bir nesne aracılığıyla CArchive bir dosyaya yazılır ve dosyadan okunur.
CFrameWnd::GetDockState , tüm çerçeve penceresinin CControlBar nesnelerinin durum bilgilerini alır ve nesneye CDockState yerleştirir. Ardından serialize veya CDockState::SaveState ile nesnenin CDockState içeriğini depolamaya yazabilirsiniz. Daha sonra çerçeve penceresindeki denetim çubuklarının durumunu geri yüklemek isterseniz, durumu veya CDockState::LoadState ile Serialize yükleyebilir, ardından kaydedilmiş durumu çerçeve penceresinin denetim çubuklarına uygulamak için CFrameWnd::SetDockState kullanabilirsiniz.
Denetim çubuklarını yerleştirme hakkında daha fazla bilgi için Denetim Çubukları, Araç Çubukları: Yerleştirme ve Kayan ve Çerçeve Pencereleri makalelerine bakın.
Devralma Hiyerarşisi
CDockState
Gereksinimler
Üst bilgi: afxadv.h
CDockState::Clear
Nesnede depolanan tüm yerleştirme bilgilerini temizlemek için bu işlevi çağırın CDockState .
void Clear();
Açıklamalar
Bu yalnızca çubuğun yerleşik olup olmadığını değil, çubuğun boyutunu ve konumunu ve görünür olup olmadığını da içerir.
CDockState::GetVersion
Depolanan çubuk durumunun sürüm numarasını almak için bu işlevi çağırın.
DWORD GetVersion();
Dönüş Değeri
Depolanan çubuk bilgileri geçerli çubuk durumundan eskiyse 1; Depolanan çubuk bilgileri geçerli çubuk durumuyla aynıysa 2.
Açıklamalar
Sürüm desteği, düzeltilmiş bir çubuğun yeni kalıcı özellikler eklemesine ve çubuğun önceki bir sürümü tarafından oluşturulan kalıcı durumu algılayıp yükleyebilmesine olanak tanır.
CDockState::LoadState
Kayıt defterinden veya konumundan durum bilgilerini almak için bu işlevi çağırın. INI dosyası.
void LoadState(LPCTSTR lpszProfileName);
Parametreler
lpszProfileName
Başlatma dosyasındaki bir bölümün adını veya Windows kayıt defterindeki durum bilgilerinin depolandığı anahtarı belirten null olarak sonlandırılan bir dizeye işaret eder.
Açıklamalar
Profil adı, uygulamanın bölümünün adıdır. INI dosyası veya çubukların durum bilgilerini içeren kayıt defteri. Denetim çubuğu durum bilgilerini kayıt defterine veya öğesine kaydedebilirsiniz. ile SaveStateINI dosyası.
CDockState::m_arrBarInfo
CPtrArray Nesneye durum bilgilerini kaydeden her denetim çubuğu için depolanan denetim çubuğu bilgilerine CDockState yönelik bir işaretçi dizisi olan nesne.
CPtrArray m_arrBarInfo;
CDockState::SaveState
Durum bilgilerini kayıt defterine veya öğesine kaydetmek için bu işlevi çağırın. INI dosyası.
void SaveState(LPCTSTR lpszProfileName);
Parametreler
lpszProfileName
Başlatma dosyasındaki bir bölümün adını veya Windows kayıt defterindeki durum bilgilerinin depolandığı anahtarı belirten null teminatlı bir dizeye işaret eder.
Açıklamalar
Profil adı, uygulamanın bölümünün adıdır. INI dosyası veya denetim çubuğunun durum bilgilerini içeren kayıt defteri. SaveState ayrıca geçerli ekran boyutunu kaydeder. Denetim çubuğu bilgilerini kayıt defterinden veya içinden alabilirsiniz. ile LoadStateINI dosyası.