CMFCPropertySheet Sınıfı

Makale
06/16/2023

sınıfı, CMFCPropertySheet her özellik sayfasının bir sayfa sekmesi, araç çubuğu düğmesi, ağaç denetim düğümü veya liste öğesiyle belirtildiği bir özellik sayfasını destekler.

Sözdizimi

class CMFCPropertySheet : public CPropertySheet

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
CMFCPropertySheet::CMFCPropertySheet	Bir `CMFCPropertySheet` nesne oluşturur.
`CMFCPropertySheet::~CMFCPropertySheet`	Yıkıcı.

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCPropertySheet::AddPage	Özellik sayfasına bir sayfa ekler.
CMFCPropertySheet::AddPageToTree	Ağaç denetimine yeni bir özellik sayfası ekler.
CMFCPropertySheet::AddTreeCategory	Ağaç denetimine yeni bir düğüm ekler.
CMFCPropertySheet::EnablePageHeader	Özel üst bilgi çizmek için her sayfanın en üstünde yer ayırır.
CMFCPropertySheet::GetHeaderHeight	Geçerli üst bilginin yüksekliğini alır.
CMFCPropertySheet::GetLook	Geçerli özellik sayfasının görünümünü belirten bir numaralandırma değeri alır.
CMFCPropertySheet::GetNavBarWidth	Gezinti çubuğunun genişliğini piksel cinsinden yeniden denenir.
CMFCPropertySheet::GetTab	Geçerli özellik sayfası denetimini destekleyen iç sekme denetimi nesnesini alır.
`CMFCPropertySheet::GetThisClass`	Çerçeve tarafından, bu sınıf türüyle ilişkili CRuntimeClass nesnesine bir işaretçi almak için kullanılır.
CMFCPropertySheet::InitNavigationControl	Geçerli özellik sayfası denetiminin görünümünü başlatır.
CMFCPropertySheet::OnActivatePage	Özellik sayfası etkinleştirildiğinde çerçeve tarafından çağrılır.
CMFCPropertySheet::OnDrawPageHeader	Özel özellik sayfası üst bilgisi çizmek için çerçeve tarafından çağrılır.
`CMFCPropertySheet::OnInitDialog`	WM_INITDIALOG iletisini işler. (Geçersiz Kılmalar CPropertySheet::OnInitDialog.)
CMFCPropertySheet::OnRemoveTreePage	Bir ağaç denetiminden özellik sayfasını kaldırmak için çerçeve tarafından çağrılır.
`CMFCPropertySheet::PreTranslateMessage`	Pencere iletilerini TranslateMessage ve DispatchMessage Windows işlevlerine göndermeden önce çevirir. (Geçersiz Kılmalar `CPropertySheet::PreTranslateMessage`.)
CMFCPropertySheet::RemoveCategory	Ağaç denetiminden bir düğümü kaldırır.
CMFCPropertySheet::RemovePage	Özellik sayfasından özellik sayfasını kaldırır.
CMFCPropertySheet::SetIconsList	Outlook bölmesinin gezinti denetiminde kullanılan görüntülerin listesini belirtir.
CMFCPropertySheet::SetLook	Özellik sayfasının görünümünü belirtir.

Açıklamalar

CMFCPropertySheet sınıfı, sekme iletişim kutuları olarak da bilinen özellik sayfalarını temsil eder. CMFCPropertySheet sınıfı bir özellik sayfasını çeşitli yollarla görüntüleyebilir.

Sınıfı uygulamanızda kullanmak CMFCPropertySheet için aşağıdaki adımları gerçekleştirin:

sınıfından CMFCPropertySheet bir sınıf türetin ve sınıfına CMyPropertySheet gibi bir ad verin.
Her özellik sayfası için bir CMFCPropertyPage nesnesi oluşturma.
CMyPropertySheet oluşturucusunda CMFCPropertySheet::SetLook yöntemini çağırın. Bu yöntemin parametresi, özellik sayfalarının özellik sayfasının üst veya sol tarafında sekmeler olarak görüntüleneceğini belirtir; Microsoft OneNote özellik sayfasının stilindeki sekmeler; Microsoft Outlook araç çubuğu denetimindeki düğmeler; ağaç denetimindeki düğümler; veya özellik sayfasının sol tarafındaki öğelerin listesi olarak.
Microsoft Outlook araç çubuğu stilinde bir özellik sayfası oluşturursanız, görüntü listesini özellik sayfalarıyla ilişkilendirmek için CMFCPropertySheet::SetIconsList yöntemini çağırın.
Her özellik sayfası için CMFCPropertySheet::AddPage yöntemini çağırın.
Bir CMFCPropertySheet denetim oluşturun ve yöntemini çağırin DoModal .

İllüstrasyonlar

Aşağıdaki çizimde, eklenmiş bir Microsoft Outlook araç çubuğu stilinde bir özellik sayfası gösterilmektedir. Özellik sayfasının sol tarafında Outlook araç çubuğu görüntülenir.

CMFCPropertySheet renk denetimleri.

Aşağıdaki çizimde, CMFCPropertyGridCtrl Sınıfı nesnesi içeren bir özellik sayfası gösterilmektedir. Bu nesne, standart ortak denetimler özellik sayfası stilinde bir özellik sayfasıdır.

CMFCPropertySheet listesi ve özellik denetimleri.

Aşağıdaki çizimde, ağaç denetimi stilinde bir özellik sayfası gösterilmektedir.

Özellik Ağacı.

Devralma Hiyerarşisi

Gereksinimler

Üst bilgi: afxpropertysheet.h

CMFCPropertySheet::AddPage

Özellik sayfasına bir sayfa ekler.

void AddPage(CPropertyPage* pPage);

Parametreler

pPage
[in] Sayfa nesnesi işaretçisi. Bu parametre NULL olamaz.

Açıklamalar

Bu yöntem, belirtilen özellik sayfasını özellik sayfasında en sağdaki sekme olarak ekler. Bu nedenle, sayfaları soldan sağa sırada eklemek için bu yöntemi kullanın.

Özellik sayfası Microsoft Outlook stilindeyse, çerçeve özellik sayfasının sol tarafındaki gezinti düğmelerinin listesini görüntüler. Bu yöntem bir özellik sayfası ekledikten sonra, listeye karşılık gelen bir düğme ekler. Özellik sayfasını görüntülemek için ilgili düğmesine tıklayın. Özellik sayfalarının stilleri hakkında daha fazla bilgi için bkz . CMFCPropertySheet::SetLook.

CMFCPropertySheet::AddPageToTree

Ağaç denetimine yeni bir özellik sayfası ekler.

void AddPageToTree(
    CMFCPropertySheetCategoryInfo* pCategory,
    CMFCPropertyPage* pPage,
    int nIconNum=-1,
    int nSelIconNum=-1);

Parametreler

pCategory
[in] Bir üst ağaç düğümü işaretçisi veya belirtilen sayfayı üst düzey düğümle ilişkilendirmek için NULL. Bu işaretçiyi almak için CMFCPropertySheet::AddTreeCategory yöntemini çağırın.

pPage
[in] Özellik sayfası nesnesinin işaretçisi.

nIconNum
[in] Simgenin sıfır tabanlı dizini veya simge kullanılmadıysa -1. Sayfa seçili olmadığında ağaç denetimi özellik sayfasının yanında simge görüntülenir. Varsayılan değer -1'dir.

nSelIconNum
[in] Simgenin sıfır tabanlı dizini veya simge kullanılmadıysa -1. Simge, sayfa seçildiğinde ağaç denetimi özellik sayfasının yanında görüntülenir. Varsayılan değer -1'dir.

Açıklamalar

Bu yöntem, bir ağaç denetiminin yaprağı olarak bir özellik sayfası ekler. Özellik sayfası eklemek için bir CMFCPropertySheet nesne oluşturun, look parametresi olarak ayarlanmış CMFCPropertySheet::PropSheetLook_TreeCMFCPropertySheet::SetLook yöntemini çağırın ve ardından özellik sayfasını eklemek için bu yöntemi kullanın.

CMFCPropertySheet::AddTreeCategory

Ağaç denetimine yeni bir düğüm ekler.

CMFCPropertySheetCategoryInfo* AddTreeCategory(
    LPCTSTR lpszLabel,
    int nIconNum=-1,
    int nSelectedIconNum=-1,
    const CMFCPropertySheetCategoryInfo* pParentCategory=NULL);

Parametreler

lpszLabel
[in] Düğümün adı.

nSelectedIconNum
[in] Simgenin sıfır tabanlı dizini veya simge kullanılmadıysa -1. Simge, sayfa seçildiğinde ağaç denetimi özellik sayfasının yanında görüntülenir. Varsayılan değer -1'dir.

pParentCategory
[in] Bir üst ağaç düğümü işaretçisi veya belirtilen sayfayı üst düzey düğümle ilişkilendirmek için NULL. Bu parametreyi CMFCPropertySheet::AddTreeCategory yöntemiyle ayarlayın.

Dönüş Değeri

Ağaç denetimindeki yeni düğümün işaretçisi.

Açıklamalar

Ağaç denetimine kategori olarak da adlandırılan yeni bir düğüm eklemek için bu yöntemi kullanın. Düğüm eklemek için bir CMFCPropertySheet nesne oluşturun, look parametresi olarak ayarlanmış CMFCPropertySheet::PropSheetLook_TreeCMFCPropertySheet::SetLook yöntemini çağırın ve düğümü eklemek için bu yöntemi kullanın.

SONRAKI CMFCPropertySheet::AddPageToTree ve CMFCPropertySheet::AddTreeCategory çağrılarında bu yöntemin dönüş değerini kullanın.

CMFCPropertySheet::CMFCPropertySheet

Bir CMFCPropertySheet nesne oluşturur.

CMFCPropertySheet(
    UINT nIDCaption,
    CWnd* pParentWnd=NULL,
    UINT iSelectPage=0);

CMFCPropertySheet(
    LPCTSTR pszCaption,
    CWnd* pParentWnd=NULL,
    UINT iSelectPage=0);

Parametreler

pszCaption
[in] Özellik sayfası resim yazısını içeren bir dize. NULL olamaz.

nIDCaption
[in] Özellik sayfası resim yazısını içeren kaynak kimliği.

pParentWnd
[in] Özellik sayfasının üst penceresine işaretçi veya uygulamanın ana penceresi üst pencereyse NULL. Varsayılan değer NULL'dir.

iSelectPage
[in] Üst özellik sayfasının sıfır tabanlı dizini. Varsayılan değer 0'tir.

Açıklamalar

Daha fazla bilgi için CPropertySheet::CPropertySheet oluşturucusunun parametrelerine bakın.

CMFCPropertySheet::EnablePageHeader

Özel üst bilgi çizmek için her sayfanın en üstünde yer ayırır.

void EnablePageHeader(int nHeaderHeight);

Parametreler

nHeaderHeight
[in] Üst bilginin piksel cinsinden yüksekliği.

Açıklamalar

Özel üst bilgi çizmek için nHeaderHeight parametresinin değerini kullanmak için CMFCPropertySheet::OnDrawPageHeader yöntemini geçersiz kılın.

CMFCPropertySheet::GetHeaderHeight

Geçerli üst bilginin yüksekliğini alır.

int GetHeaderHeight() const;

Dönüş Değeri

Üst bilginin piksel cinsinden yüksekliği.

Açıklamalar

Bu yöntemi çağırmadan önce CMFCPropertySheet::EnablePageHeader yöntemini çağırın.

CMFCPropertySheet::GetLook

Geçerli özellik sayfasının görünümünü belirten bir numaralandırma değeri alır.

PropSheetLook GetLook() const;

Dönüş Değeri

Özellik sayfasının görünümünü belirten numaralandırma değerlerinden biri. Olası değerlerin listesi için, CMFCPropertySheet::SetLook öğesinin Açıklamalar bölümündeki numaralandırma tablosuna bakın.

CMFCPropertySheet::GetNavBarWidth

Gezinti çubuğunun genişliğini alır.

int GetNavBarWidth() const;

Dönüş Değeri

Gezinti çubuğunun piksel cinsinden genişliği.

CMFCPropertySheet::GetTab

Geçerli özellik sayfası denetimini destekleyen iç sekme denetimi nesnesini alır.

CMFCTabCtrl& GetTab() const;

Dönüş Değeri

İç sekme denetimi nesnesi.

Açıklamalar

Bir özellik sayfasını ağaç denetimi, gezinti düğmeleri listesi veya sekmeli sayfa kümesi gibi farklı stillerde görünecek şekilde ayarlayabilirsiniz.

Bu yöntemi çağırmadan önce, özellik sayfası denetiminin görünümünü ayarlamak için CMFCPropertySheet::SetLook yöntemini çağırın. Ardından, iç sekme denetim nesnesini başlatmak için CMFCPropertySheet::InitNavigationControl yöntemini çağırın. Sekme denetim nesnesini almak için bu yöntemi kullanın ve ardından özellik sayfasındaki sekmelerle çalışmak için bu nesneyi kullanın.

Özellik sayfası denetimi Microsoft OneNote stilinde görünecek şekilde ayarlanmadıysa bu yöntem hata ayıklama modunda onaylar.

CMFCPropertySheet::InitNavigationControl

Geçerli özellik sayfası denetiminin görünümünü başlatır.

virtual CWnd* InitNavigationControl();

Dönüş Değeri

Özellik sayfası denetiminin penceresinin işaretçisi.

Açıklamalar

Özellik sayfası denetimi, sekmeli sayfalar, ağaç denetimi veya gezinti düğmeleri listesi gibi birkaç farklı biçimde görüntülenebilir. Özellik sayfası denetiminin görünümünü belirtmek için CMFCPropertySheet::SetLook yöntemini kullanın.

CMFCPropertySheet::OnActivatePage

Özellik sayfası etkinleştirildiğinde çerçeve tarafından çağrılır.

virtual void OnActivatePage(CPropertyPage* pPage);

Parametreler

pPage
[in] Etkin özellik sayfasını temsil eden bir özellik sayfası nesnesi işaretçisi.

Açıklamalar

Varsayılan olarak, bu yöntem etkin özellik sayfasının görünüme kaydırılmasını sağlar. Geçerli özellik sayfasının stili bir Microsoft Outlook bölmesi içeriyorsa, bu yöntem ilgili Outlook düğmesini işaretli duruma ayarlar.

CMFCPropertySheet::OnDrawPageHeader

Özel özellik sayfasının üst bilgisini çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawPageHeader(
    CDC* pDC,
    int nPage,
    CRect rectHeader);

Parametreler

pDC
[in] Cihaz bağlamı işaretçisi.

nSayfa
[in] Sıfır tabanlı özellik sayfa numarası.

rectHeader
[in] Üst bilginin nereye çizildiğini belirten sınırlayıcı dikdörtgen.

Açıklamalar

Varsayılan olarak, bu yöntem hiçbir şey yapmaz. Bu yöntemi geçersiz kılarsanız, çerçeve bu yöntemi çağırmadan önce CMFCPropertySheet::EnablePageHeader yöntemini çağırın.

CMFCPropertySheet::OnRemoveTreePage

Bir ağaç denetiminden özellik sayfasını kaldırmak için çerçeve tarafından çağrılır.

virtual BOOL OnRemoveTreePage(CPropertyPage* pPage);

Parametreler

pPage
[in] Kaldırılacak özellik sayfasını temsil eden bir özellik sayfası nesnesi işaretçisi.

Dönüş Değeri

Bu yöntem başarılı olursa TRUE; aksi takdirde YANLIŞ.

CMFCPropertySheet::RemoveCategory

Ağaç denetiminden bir düğümü kaldırır.

void RemoveCategory(CMFCPropertySheetCategoryInfo* pCategory);

Parametreler

pCategory
[in] Kaldırılacak kategori (düğüm) işaretçisi.

Açıklamalar

Bir ağaç denetiminden kategori olarak da adlandırılan bir düğümü kaldırmak için bu yöntemi kullanın. Ağaç denetimine düğüm eklemek için CMFCPropertySheet::AddTreeCategory yöntemini kullanın.

CMFCPropertySheet::RemovePage

Özellik sayfasından özellik sayfasını kaldırır.

void RemovePage(CPropertyPage* pPage);
void RemovePage(int nPage);

Parametreler

pPage
[in] Kaldırılacak özellik sayfasını temsil eden özellik sayfası nesnesi işaretçisi. NULL olamaz.

nSayfa
[in] Kaldırılacak sayfanın sıfır tabanlı dizini.

Açıklamalar

Bu yöntem, belirtilen özellik sayfasını kaldırır ve ilişkili penceresini yok eder. pPage parametresinin belirttiği özellik sayfası nesnesi, CMFCPropertySheet penceresi kapatılana kadar yok edilmez.

CMFCPropertySheet::SetIconsList

Outlook bölmesinin gezinti denetiminde kullanılan görüntülerin listesini belirtir.

BOOL SetIconsList(
    UINT uiImageListResID,
    int cx,
    COLORREF clrTransparent=RGB(255, 0, 255));
void SetIconsList(HIMAGELIST hIcons);

Parametreler

uiImageListResID
[in] Görüntü listesinin kaynak kimliği.

cx
[in] Resim listesindeki simgelerin piksel cinsinden genişliği.

clrTransparent
[in] Saydam resim rengi. Resmin bu renkteki bölümleri saydam olacaktır. Varsayılan değer macenta rengidir, RGB (255,0,255).

hIcons
[in] Mevcut görüntü listesinin tanıtıcısı.

Dönüş Değeri

İlk yöntem aşırı yükleme söz diziminde, bu yöntem başarılı olursa DOĞRU; aksi takdirde YANLIŞ.

Açıklamalar

Özellik sayfası Microsoft Outlook stilindeyse, çerçeve özellik sayfasının sol tarafındaki Outlook bölmesi denetimi olarak adlandırılan gezinti düğmelerinin listesini görüntüler. Outlook bölme denetimi tarafından kullanılacak görüntü listesini ayarlamak için bu yöntemi kullanın.

Bu yöntemi destekleyen yöntemler hakkında daha fazla bilgi için bkz . CImageList::Create ve CImageList::Add. Özellik sayfasının stilini ayarlama hakkında daha fazla bilgi için bkz . CMFCPropertySheet::SetLook.

CMFCPropertySheet::SetLook

Özellik sayfasının görünümünü belirtir.

void SetLook(
    PropSheetLook look,
    int nNavControlWidth=100);

Parametreler

bakmak
[in] Özellik sayfasının görünümünü belirten numaralandırma değerlerinden biri. Özellik sayfasının varsayılan stili şeklindedir CMFCPropertySheet::PropSheetLook_Tabs. Daha fazla bilgi için bu konunun Açıklamalar bölümündeki tabloya bakın.

nNavControlWidth
[in] Gezinti denetiminin piksel cinsinden genişliği. Varsayılan değer 100 şeklindedir.

Açıklamalar

Özellik sayfasını varsayılandan farklı bir stilde görüntülemek için, özellik sayfası penceresini oluşturmadan önce bu yöntemi çağırın.

Aşağıdaki tabloda look parametresinde belirtilebilen numaralandırma değerleri listelenir.

Value	Açıklama
`CMFCPropertySheet::PropSheetLook_Tabs`	(Varsayılan) Her özellik sayfası için bir sekme görüntüler. Sekmeler özellik sayfasının en üstünde görüntülenir ve tek bir satıra sığmayacak kadar çok sekme varsa yığılır.
`CMFCPropertySheet::PropSheetLook_OutlookBar`	Özellik sayfasının sol tarafında, Microsoft Outlook çubuğunun stilinde gezinti düğmelerinin listesini görüntüler. Listedeki her düğme bir özellik sayfasına karşılık gelir. Çerçeve, listenin görünür alanına sığmayacak kadar çok düğme varsa kaydırma oklarını görüntüler.
`CMFCPropertySheet::PropSheetLook_Tree`	Özellik sayfasının sol tarafında bir ağaç denetimi görüntüler. Ağaç denetiminin her üst veya alt düğümü bir özellik sayfasına karşılık gelir. Ağaç denetiminin görünür alanına sığmayacak kadar çok düğüm varsa çerçeve kaydırma oklarını görüntüler.
`CMFCPropertySheet::PropSheetLook_OneNoteTabs`	Her özellik sayfası için Microsoft OneNote stilinde bir sekme görüntüler. Çerçeve, özellik sayfasının en üstünde sekmeleri ve tek bir satıra sığmayacak kadar çok sekme varsa kaydırma oklarını görüntüler.
`CMFCPropertySheet::PropSheetLook_List`	Özellik sayfasının sol tarafında bir liste görüntüler. Her liste öğesi bir özellik sayfasına karşılık gelir. Çerçeve, listenin görünür alanına sığacak kadar çok liste öğesi varsa kaydırma oklarını görüntüler.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar
CMFCPropertyPage Sınıfı
CMFCOutlookBar Sınıfı

Aracılığıyla paylaş

CMFCPropertySheet Sınıfı

Sözdizimi

Üyeler

Ortak Oluşturucular

Genel Yöntemler

Açıklamalar

İllüstrasyonlar

Devralma Hiyerarşisi

Gereksinimler

CMFCPropertySheet::AddPage

Parametreler

Açıklamalar

CMFCPropertySheet::AddPageToTree

Parametreler

Açıklamalar

CMFCPropertySheet::AddTreeCategory

Parametreler

Dönüş Değeri

Açıklamalar

CMFCPropertySheet::CMFCPropertySheet

Parametreler

Açıklamalar

CMFCPropertySheet::EnablePageHeader

Parametreler

Açıklamalar

CMFCPropertySheet::GetHeaderHeight

Dönüş Değeri

Açıklamalar

CMFCPropertySheet::GetLook

Dönüş Değeri

CMFCPropertySheet::GetNavBarWidth

Dönüş Değeri

CMFCPropertySheet::GetTab

Dönüş Değeri

Açıklamalar

CMFCPropertySheet::InitNavigationControl

Dönüş Değeri

Açıklamalar

CMFCPropertySheet::OnActivatePage

Parametreler

Açıklamalar

CMFCPropertySheet::OnDrawPageHeader

Parametreler

Açıklamalar

CMFCPropertySheet::OnRemoveTreePage

Parametreler

Dönüş Değeri

CMFCPropertySheet::RemoveCategory

Parametreler

Açıklamalar

CMFCPropertySheet::RemovePage

Parametreler

Açıklamalar

CMFCPropertySheet::SetIconsList

Parametreler

Dönüş Değeri

Açıklamalar

CMFCPropertySheet::SetLook

Parametreler

Açıklamalar

Ayrıca bkz.

Geri Bildirim

Ek kaynaklar