CMFCPropertyGridCtrl Sınıfı

Daha fazla ayrıntı için Visual Studio yüklemenizin mfc klasöründe bulunan kaynak koduna bakın. Örneğin, %ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc.

Özellikleri alfabetik veya hiyerarşik sırada görüntüleyebilen düzenlenebilir özellik kılavuzu denetimini destekler.

Sözdizimi

class CMFCPropertyGridCtrl : public CWnd

Üyeler

Ortak Oluşturucular

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

Genel Yöntemler

Veri Akışı Adı	Açıklama
CMFCPropertyGridCtrl::accHitTest	Ekranın belirli bir noktasında alt öğeyi veya alt nesneyi almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::accHitTest.)
CMFCPropertyGridCtrl::accLocation	Belirtilen nesnenin geçerli ekran konumunu almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::accLocation.)
CMFCPropertyGridCtrl::accSelect	Seçileni değiştirmek veya belirtilen nesnenin klavye odağını taşımak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::accSelect.)
CMFCPropertyGridCtrl::AddProperty	Özellik kılavuzu denetimine yeni bir özellik ekler.
CMFCPropertyGridCtrl::AlwaysShowUserToolTip
CMFCPropertyGridCtrl::CloseColorPopup	Renk seçimi iletişim kutusunu kapatır.
CMFCPropertyGridCtrl::Create	Bir özellik kılavuzu denetimi oluşturur ve bunu özellik kılavuzu denetim nesnesine ekler.
CMFCPropertyGridCtrl::DeleteProperty	Belirtilen özelliği özellik kılavuzu denetiminden siler.
CMFCPropertyGridCtrl::DrawControlBarColors
CMFCPropertyGridCtrl::EnableDescriptionArea	Özellik listesinin altında görüntülenen açıklama alanını etkinleştirir veya devre dışı bırakır.
CMFCPropertyGridCtrl::EnableHeaderCtrl	Özellik kılavuzu denetiminin üst kısmındaki üst bilgi denetimini etkinleştirir veya devre dışı bırakır.
CMFCPropertyGridCtrl::EnsureVisible	Bir özellik kılavuzu denetimini kaydırarak belirtilen özellik görünene kadar özellik öğelerini genişletir.
CMFCPropertyGridCtrl::ExpandAll	Tüm özellik kılavuzu denetim düğümlerini genişletir veya daraltir.
CMFCPropertyGridCtrl::FindItemByData	Kullanıcı tanımlı DWORD bir değerle ilişkili özelliği alır.
CMFCPropertyGridCtrl::get_accChild	Belirtilen alt öğenin arabiriminin IDispatch adresini almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accChild.)
CMFCPropertyGridCtrl::get_accChildCount	Bu nesneye ait alt öğe sayısını almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accChildCount.)
CMFCPropertyGridCtrl::get_accDefaultAction	Nesnenin varsayılan eylemini açıklayan bir dizeyi almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accDefaultAction.)
CMFCPropertyGridCtrl::get_accDescription	Belirtilen nesnenin görsel görünümünü açıklayan bir dizeyi almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accDescription.)
CMFCPropertyGridCtrl::get_accFocus	Klavye odağı olan nesneyi almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accFocus.)
CMFCPropertyGridCtrl::get_accHelp	Bir nesnenin Help özellik dizesini almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accHelp.)
CMFCPropertyGridCtrl::get_accHelpTopic	Belirtilen nesneyle ilişkili dosyanın tam yolunu WinHelp ve bu dosya içindeki uygun konunun tanımlayıcısını almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accHelpTopic.)
CMFCPropertyGridCtrl::get_accKeyboardShortcut	Belirtilen nesnenin kısayol tuşunu veya erişim tuşunu almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accKeyboardShortcut.)
CMFCPropertyGridCtrl::get_accName	Belirtilen nesnenin adını almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accName.)
CMFCPropertyGridCtrl::get_accRole	Belirtilen nesnenin rolünü açıklayan bilgileri almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accRole.)
CMFCPropertyGridCtrl::get_accSelection	Bu nesnenin seçili alt öğelerini almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accSelection.)
CMFCPropertyGridCtrl::get_accState	Belirtilen nesnenin geçerli durumunu almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accState.)
CMFCPropertyGridCtrl::get_accValue	Belirtilen nesnenin değerini almak için çerçeve tarafından çağrılır. (Geçersiz Kılmalar CWnd::get_accValue.)
CMFCPropertyGridCtrl::GetBkColor	Geçerli özellik kılavuzu denetiminin arka plan rengini alır.
CMFCPropertyGridCtrl::GetBoldFont	Geçerli özellik kılavuzu denetimindeki metnin Windows yazı tipini kalın stilde alır.
CMFCPropertyGridCtrl::GetCurSel	Seçili durumdaki özelliği alır.
CMFCPropertyGridCtrl::GetCustomColors	Özellik kılavuzu denetim öğeleri için şu anda tanımlanmış olan özel renkleri alır.
CMFCPropertyGridCtrl::GetDescriptionHeight	Özellik kılavuzu denetiminin en altında bulunan açıklama alanının yüksekliğini alır.
CMFCPropertyGridCtrl::GetDescriptionRows	Geçerli özellik kılavuzu denetiminin açıklama alanındaki satır sayısını alır.
CMFCPropertyGridCtrl::GetHeaderCtrl	Çerçevenin geçerli özellik kılavuzu denetimini görüntülemek için kullandığı iç CMFCHeaderCtrl nesneyi alır.
CMFCPropertyGridCtrl::GetHeaderHeight	Özellik kılavuzu denetim üst bilgisinin yüksekliğini alır.
CMFCPropertyGridCtrl::GetLeftColumnWidth	Her özelliğin adını içeren geçerli özellik kılavuzu denetiminin sol sütununun genişliğini alır.
CMFCPropertyGridCtrl::GetListRect	Özellik kılavuzu denetiminin sınırlayıcı dikdörtgenini alır.
CMFCPropertyGridCtrl::GetProperty	Özellik kılavuzu denetim öğesinin belirtilen dizinine karşılık gelen özellik nesnesine yönelik bir işaretçi alır.
CMFCPropertyGridCtrl::GetPropertyColumnWidth	Özellik değerlerini içeren sütunun geçerli genişliğini alır.
CMFCPropertyGridCtrl::GetPropertyCount	Özellik kılavuzu denetimindeki özelliklerin sayısını alır.
CMFCPropertyGridCtrl::GetRowHeight	Özellik kılavuzu denetimindeki bir satırın yüksekliğini alır.
CMFCPropertyGridCtrl::GetScrollBarCtrl	Özellik kılavuzu denetiminde kaydırma çubuğu denetiminin işaretçisini alır. (Geçersiz Kılmalar CWnd::GetScrollBarCtrl.)
CMFCPropertyGridCtrl::GetTextColor	Geçerli özellik kılavuzu denetimindeki özellik öğelerinin metninin rengini alır.
CMFCPropertyGridCtrl::GetThisClass	Çerçeve tarafından, bu sınıf türüyle ilişkili nesneye CRuntimeClass bir işaretçi almak için kullanılır.
CMFCPropertyGridCtrl::HitTest	Öğede belirtilen bir nokta varsa, özellik kılavuzu denetim öğesine karşılık gelen özellik nesnesine bir işaretçi alır. Bu yöntem ayrıca özellik kılavuzu denetiminde noktayı içeren alanı gösterir.
CMFCPropertyGridCtrl::InitHeader	Çerçevenin geçerli özellik kılavuzu denetimini görüntülemek için kullandığı iç CMFCHeaderCtrl nesneyi başlatır.
CMFCPropertyGridCtrl::IsAlphabeticMode	Özellik kılavuzu denetiminin alfabetik modda olup olmadığını gösterir.
CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip
CMFCPropertyGridCtrl::IsDescriptionArea	Özellik kılavuzu denetiminin açıklama alanının görüntülenip görüntülenmeyeceğini gösterir.
CMFCPropertyGridCtrl::IsGroupNameFullWidth	Her özellik grubu adının geçerli özellik kılavuzu denetiminin genişliği boyunca görüntülenip görüntülenmeyeceğini gösterir.
CMFCPropertyGridCtrl::IsHeaderCtrl	Üst bilgi denetiminin görüntülenip görüntülenmeyeceğini gösterir.
CMFCPropertyGridCtrl::IsMarkModifiedProperties	Özellik kılavuzu denetiminin değiştirilmiş özellikleri nasıl görüntülediğini gösterir.
CMFCPropertyGridCtrl::IsShowDragContext	Kullanıcı sütunları yeniden boyutlandırdığında çerçevenin geçerli özellik kılavuzu denetiminin ad ve değer sütunlarını yeniden çizip çizmediğini gösterir.
CMFCPropertyGridCtrl::IsVSDotNetLook	Özellik kılavuzu denetiminin görünümünün VS .NET tarafından kullanılan stilde olup olmadığını gösterir.
CMFCPropertyGridCtrl::MarkModifiedProperties	Değiştirilen özelliklerin nasıl görüntüleneceğini belirtir.
CMFCPropertyGridCtrl::PreTranslateMessage	ve DispatchMessage Windows işlevlerine dağıtilmeden önce pencere iletilerini çevirmek için TranslateMessage sınıf CWinApp tarafından kullanılır. (Geçersiz Kılmalar CWnd::PreTranslateMessage.)
CMFCPropertyGridCtrl::RemoveAll	Bir özellik kılavuzu denetiminden tüm özellik nesnelerini kaldırır.
CMFCPropertyGridCtrl::ResetOriginalValues	Tüm özelliklerin özgün değerini geri yükler.
CMFCPropertyGridCtrl::SetAlphabeticMode	Alfabetik modu ayarlar veya sıfırlar.
CMFCPropertyGridCtrl::SetBoolLabels	Boole etiketlerinin metnini belirtir.
CMFCPropertyGridCtrl::SetCurSel	Özellik kılavuzu denetiminde bir özellik seçer.
CMFCPropertyGridCtrl::SetCustomColors	Çeşitli özellik kılavuzu denetim öğeleri için özel renkleri belirtir.
CMFCPropertyGridCtrl::SetDescriptionRows	Geçerli özellik kılavuzu denetiminin açıklama bölümünde görüntülenecek satır sayısını belirtir.
CMFCPropertyGridCtrl::SetGroupNameFullWidth	Geçerli özellik kılavuzu denetimindeki bir özellik grubu için kategori adının tam genişliğinin görüntülenip görüntülenmeyeceğini belirtir.
CMFCPropertyGridCtrl::SetListDelimiter	Özellik değerleri listesinde sınırlayıcı olarak kullanılacak karakteri tanımlar.
CMFCPropertyGridCtrl::SetShowDragContext	Kullanıcı sütunları yeniden boyutlandırdığında çerçevenin geçerli özellik kılavuzu denetiminin ad ve değer sütunlarını yeniden çizip çizmeyeceğini belirtir.
CMFCPropertyGridCtrl::SetVSDotNetLook	Özellik kılavuzu denetiminin görünümünü VS .NET'te kullanılan stile ayarlar.
CMFCPropertyGridCtrl::UpdateColor	Seçili durumdaki renk özelliğinin renk değerini ayarlar.

Korumalı Yöntemler

Veri Akışı Adı	Açıklama
CMFCPropertyGridCtrl::AdjustLayout	Özellik kılavuzu denetimini ve özelliklerini yeniden çizer.
CMFCPropertyGridCtrl::CompareProps	Özellikleri sıralamak için özellik kılavuzu denetimi tarafından çağrılır.
CMFCPropertyGridCtrl::EditItem	Kullanıcı bir özelliği değiştirmeye başladığında çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::EndEditItem	Kullanıcı bir özelliği değiştirmeyi durdurduğunda çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::Init	Bir özellik kılavuzu denetimini başlatmak için çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::OnChangeSelection	Geçerli seçim değiştirildiğinde çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::OnClickButton	Bir özellik düğmesine tıklandığında çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::OnDrawBorder	Bir özellik kılavuzu denetiminin çevresine kenarlık çizmek için çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::OnDrawDescription	Açıklama alanını çizmek ve açıklama metnini görüntülemek için çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::OnDrawList	Özellik kılavuzu denetimindeki özelliklerin listesini görüntülemek için çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::OnDrawProperty	Bir özelliği görüntülemek için çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::OnPropertyChanged	Bir özelliğin değeri değiştirildiğinde çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::OnSelectCombo	Birleşik giriş kutusu denetimi içeren bir özellik seçildiğinde çerçeve tarafından çağrılır.
CMFCPropertyGridCtrl::ValidateItemData	Özellik verilerini doğrulamak için çerçeve tarafından çağrılır.

Açıklamalar

sınıfı, CMFCPropertyGridCtrl sınıfından CMFCPropertyGridProperty türetilen düzenlenebilir özellikleri içeren bir özellik kılavuzu denetimi görüntüler. Her özellik bir türü temsil edebilir ve alt öğeleri içerebilir. Özellik kılavuzu denetimi, seçili özelliğin açıklamasını görüntüleyebilen, alt kısımda yeniden boyutlandırılabilir bir alanı destekler.

Özellik kılavuzu denetimi kullanmak için bir CMFCPropertyGridCtrl nesne oluşturun ve yöntemini çağırın CMFCPropertyGridCtrl::Create . CMFCPropertyGridCtrl::AddProperty Listeye özellik eklemek için yöntemini kullanın.

Seçim Özellikleri

Özellik öğesi, bir değeri göstermek yerine kullanıcının bir renk, dosya veya yazı tipi seçmesine olanak tanıyan bir iletişim kutusu başlatabilir.

Aşağıdaki tabloda dört seçim özelliği türü listelenmiştir:

Sınıf	Açıklama
CMFCPropertyGridProperty Sınıf	Dizelerin, Boole'lerin, tarihlerin vb. değerini belirtmek için kullanılan genel amaçlı özellik.
CMFCPropertyGridColorProperty Sınıf	Renk değeri seçmek için kullanılan özellik.
CMFCPropertyGridFileProperty Sınıf	Dosya seçmek için kullanılan özellik.
CMFCPropertyGridFontProperty Sınıf	Yazı tipini seçmek için kullanılan özellik.

İllüstrasyonlar

Aşağıdaki çizimlerde özellikleri iki şekilde görüntüleyen bir özellik kılavuzu denetimi gösterilmektedir. İlk çizimde özellikler hiyerarşik olarak, ikinci çizimde ise özellikler alfabetik olarak görüntülenir.

Örnek

Aşağıdaki örnekte, sınıftaki çeşitli yöntemleri kullanarak bir özellik kılavuzu denetim nesnesinin nasıl yapılandırılır gösterilmektedir CMFCPropertyGridCtrl . Örnekte üst bilgi denetiminin nasıl etkinleştirileceği, açıklama alanının nasıl etkinleştirileceği ve özellik kılavuzu denetiminin görünümünün nasıl ayarlanacağı gösterilmektedir. Örnekte ayrıca denetimin içerdiği tüm özellikleri kendi özellik adına göre sıraladığı denetim için alfabetik modun nasıl ayarlanacağı ve özellik kılavuzu denetiminin çeşitli öğeleri için özel renklerin nasıl ayarlanacağı da gösterilir. Bu örnek, Yeni Denetimler örneğinin bir parçasıdır.

CMFCPropertyGridCtrl m_wndPropList;

m_wndPropList.EnableHeaderCtrl();
m_wndPropList.EnableDescriptionArea();
m_wndPropList.SetVSDotNetLook(m_bDotNetLook);
// BOOL m_bMarkChanged
m_wndPropList.MarkModifiedProperties(m_bMarkChanged);
// BOOL m_bPropListCategorized
m_wndPropList.SetAlphabeticMode(!m_bPropListCategorized);
// BOOL m_bShowDragContext
m_wndPropList.SetShowDragContext(m_bShowDragContext);

// BOOL m_bMarkSortedColumn
m_wndList.EnableMarkSortedColumn(m_bMarkSortedColumn);

// BOOL m_bPropListCustomColors
// set custom colors for various elements of the property grid control
if (m_bPropListCustomColors)
{
   m_wndPropList.SetCustomColors(RGB(228, 243, 254), RGB(46, 70, 165), RGB(200, 236, 209), RGB(33, 102, 49), RGB(255, 229, 216), RGB(128, 0, 0), RGB(159, 159, 255));
}
else
{
   COLORREF c = (COLORREF)-1;
   m_wndPropList.SetCustomColors(c, c, c, c, c, c, c);
}

m_wndPropList.RedrawWindow();

// restore original values of the properties
m_wndPropList.ResetOriginalValues();

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CMFCPropertyGridCtrl

Gereksinimler

Üstbilgi: afxpropertygridctrl.h

CMFCPropertyGridCtrl::accSelect

virtual HRESULT accSelect(
    long flagsSelect,
    VARIANT varChild);

Parametreler

[in] flagsSelect
[in] varChild\

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::AddProperty

Özellik kılavuzu denetimine yeni bir özellik ekler.

int AddProperty(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Parametreler

pProp
[in] Bir özelliğin işaretçisi.

bRedraw
[in] TRUE özelliği hemen yeniden çizmek için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

bAdjustLayout
[in] TRUE özelliğin metin ve değerini çizmeyi ve ardından özelliği çizmeyi yeniden hesaplamak için; FALSE özelliğini çizmek için mevcut hesaplamaları kullanın. Varsayılan değer şudur: TRUE.

Dönüş Değeri

Bu yöntem başarılı olursa özellik kılavuzundaki konumun sıfır tabanlı dizini özelliğin eklendiği yeri denetler; aksi takdirde, -1.

Açıklamalar

Bu yöntem, özellik kılavuzu denetimindeki özellik listesinin sonuna belirtilen özelliğe bir işaretçi ekler. Özellikleri yok etmeyin veya kılavuz denetimi yok edilmeden önce kapsam dışına çıkmalarına izin verme. Özellik kılavuzu denetimiyle işiniz bittiğinde, eklenen tüm özellikleri silmek için çağrısı CMFCPropertyGridCtrl::RemoveAll yapın. Belirtilen özellik listeye zaten eklenmişse AddProperty yöntemi başarısız olur.

CMFCPropertyGridCtrl::AdjustLayout

Özellik kılavuzu denetimini ve özelliklerini yeniden çizer.

virtual void AdjustLayout();

Açıklamalar

Bu yöntem, özellik kılavuzu denetiminin tamamının ve görüntüler, yazı tipleri ve denetimler gibi özelliklerinin nasıl çizilmiş olduğunu yeniden hesaplar.

CMFCPropertyGridCtrl::AlwaysShowUserToolTip

void AlwaysShowUserToolTip(BOOL bShow = TRUE);

Parametreler

[in] bShow\

Açıklamalar

CMFCPropertyGridCtrl::CloseColorPopup

Renk seçimi iletişim kutusunu kapatır.

virtual void CloseColorPopup();

Açıklamalar

Renk seçimi iletişim kutusu hakkında daha fazla bilgi için bkz CMFCPropertyGridColorProperty . Sınıf.

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl

Bir CMFCPropertyGridCtrl nesne oluşturur.

CMFCPropertyGridCtrl();

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::CompareProps

Özellikleri sıralamak için özellik kılavuzu denetimi tarafından çağrılır.

virtual int CompareProps(
    const CMFCPropertyGridProperty* pProp1,
    const CMFCPropertyGridProperty* pProp2) const;

Parametreler

pProp1
Bir özelliğin işaretçisi.

pProp2
Bir özelliğin işaretçisi.

Dönüş Değeri

Dönüş Değeri	Açıklama
< 0	Parametrenin pProp1 adı, parametrenin adından pProp2 küçüktür.
0	Parametrenin pProp1 adı, parametrenin pProp2 adına eşittir.
> 0	Nesnenin pProp1 adı parametrenin adından pProp2 büyüktür.

Açıklamalar

Varsayılan olarak, bu yöntem belirtilen parametrelerin üyelerini CMFCPropertyGridProperty::m_strName karşılaştırmak için yöntemini kullanırCString::Compare.

CMFCPropertyGridCtrl::Create

Bir özellik kılavuzu denetimi oluşturur ve bunu özellik kılavuzu denetim nesnesine ekler.

virtual BOOL Create(
    DWORD dwStyle,
    const RECT& rect,
    CWnd* pParentWnd,
    UINT nID);

Parametreler

dwStyle
[in] Pencere stillerinin bit düzeyinde "veya" (|) bileşimi.

rect
[in] penceresinin boyutunu ve konumunu istemci koordinatlarında pParentWndbelirten sınırlayıcı dikdörtgen.

pParentWnd
[in] Üst pencere işaretçisi. olmamalıdır NULL.

nID
[in] Alt pencerenin kimliği.

Dönüş Değeri

TRUE pencere başarıyla oluşturulduysa; aksi takdirde , FALSE.

Açıklamalar

Özellik kılavuzu denetimi oluşturmak için, önce bir özellik kılavuzu nesnesi oluşturmak için çağrısı CMFCPropertyGridCtrl::CMFCPropertyGridCtrl yapın. Ardından çağrısı yapın CMFCPropertyGridCtrl::Create.

Örnek

Aşağıdaki örnekte sınıfında yönteminin Create CMFCPropertyGridCtrl nasıl kullanılacağı gösterilmektedir. Bu örnek, Yeni Denetimler örneğinin bir parçasıdır.

// CRect rectPropList
// CMFCPropertyGridCtrl m_wndPropList
// The this pointer points to a CPage5 class which extends the CMFCPropertyPage class.
m_wndPropList.Create(WS_CHILD | WS_VISIBLE | WS_TABSTOP | WS_BORDER, rectPropList, this, (UINT)-1);

CMFCPropertyGridCtrl::DeleteProperty

Belirtilen özelliği özellik kılavuzu denetiminden siler.

BOOL DeleteProperty(
    CMFCPropertyGridProperty*& pProp,
    BOOL bRedraw=TRUE,
    BOOL bAdjustLayout=TRUE);

Parametreler

pProp
[in] Bir özelliğin işaretçisi.

bRedraw
[in] TRUE özellik kılavuzu denetimini yeniden çizmek için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

bAdjustLayout
[in] TRUE özellik kılavuzu denetimindeki tüm metin, görüntü ve öğelerin nasıl çizilmiş olduğunu yeniden hesaplamak ve ardından denetimi çizmek için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

Dönüş Değeri

TRUE bu yöntem başarılı olursa; aksi takdirde , FALSE.

Açıklamalar

Özellik kılavuzu denetiminden bir özelliği ve alt öğeleri silmek için bu yöntemi kullanın.

CMFCPropertyGridCtrl::DrawControlBarColors

BOOL DrawControlBarColors() const;

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::EditItem

Kullanıcı bir özelliği değiştirmeye başladığında çerçeve tarafından çağrılır.

virtual BOOL EditItem(
    CMFCPropertyGridProperty* pProp,
    LPPOINT lptClick=NULL);

Parametreler

pProp
[in] Bir özelliğin işaretçisi.

lptClick
[in] Kullanıcının düzenleme işlemini başlatmak için tıklamış olduğu özellik kılavuzu denetimindeki nokta. Nokta, denetimin istemci koordinatlarındadır. Varsayılan değer şudur: NULL.

Dönüş Değeri

TRUE yöntem başarılı olursa; aksi takdirde , FALSE.

Açıklamalar

CMFCPropertyGridCtrl::EnableDescriptionArea

Özellik kılavuzu denetimindeki özellik listesinin altında görüntülenen açıklama alanını etkinleştirir veya devre dışı bırakır.

void EnableDescriptionArea(BOOL bEnable=TRUE);

Parametreler

bEnable
[in] TRUE açıklama alanını etkinleştirmek için; FALSE öğesini seçin. Varsayılan değer şudur: TRUE.

Açıklamalar

Açıklama alanı, özellik kılavuzu denetiminin en altında görüntülenir. Varsayılan olarak, açıklama alanı devre dışıdır ve görünür değildir.

CMFCPropertyGridCtrl::EnableHeaderCtrl

Özellik kılavuzu denetiminin üst kısmındaki üst bilgi denetimini etkinleştirir veya devre dışı bırakır.

void EnableHeaderCtrl(
    BOOL bEnable=TRUE,
    LPCTSTR lpszLeftColumn=_T("Property"),
    LPCTSTR lpszRightColumn=_T("Value"));

Parametreler

bEnable
[in] TRUE üst bilgi denetimini etkinleştirmek için; FALSE üst bilgi denetimini devre dışı bırakmak için. Varsayılan değer şudur: TRUE.

lpszLeftColumn
[in] Üst bilgi denetiminin sol sütununun başlığı. Varsayılan değer şudur: Property.

lpszRightColumn
[in] Üst bilgi denetiminin sağ sütununun başlığı. Varsayılan değer şudur: Value.

CMFCPropertyGridCtrl::EndEditItem

Kullanıcı bir özelliği değiştirmeyi tamamladığında çerçeve tarafından çağrılır.

virtual BOOL EndEditItem(BOOL bUpdateData=TRUE);

Parametreler

bUpdateData
[in] TRUE düzenleme işlemi tamamlandığında değiştirilen özellik verilerinin doğrulanması gerektiğini belirtmek için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

Dönüş Değeri

TRUE düzenleme işlemi başarıyla sona eriyorsa; FALSE değiştirilen özellik verileri geçerli değilse veya düzenleme işleminin devam etmesi gerekiyorsa.

Açıklamalar

CMFCPropertyGridCtrl::EnsureVisible

Bir özellik kılavuzu denetimini kaydırarak belirtilen özellik görünene kadar özellik öğelerini genişletir.

void EnsureVisible(
    CMFCPropertyGridProperty* pProp,
    BOOL bExpandParents=FALSE);

Parametreler

pProp
[in] Bir özelliğin işaretçisi.

bExpandParents
[in] TRUE belirtilen özelliği görünür hale getirmek için üst öğeleri genişletmek için; aksi takdirde , FALSE. Varsayılan değer: FALSE.

Açıklamalar

CMFCPropertyGridCtrl::ExpandAll

Tüm özellik kılavuzu denetim düğümlerini genişletir veya daraltir.

void ExpandAll(BOOL bExpand=TRUE);

Parametreler

bExpand
[in] TRUE tüm düğümleri genişletmek için; FALSE tüm düğümleri daraltmak için. Varsayılan değer şudur: TRUE.

Açıklamalar

CMFCPropertyGridCtrl::FindItemByData

Kullanıcı tanımlı DWORD bir değerle ilişkili özelliği alır.

CMFCPropertyGridProperty* FindItemByData(
    DWORD_PTR dwData,
    BOOL bSearchSubItems=TRUE) const;

Parametreler

dwData
[in] Bir DWORD değer.

bSearchSubItems
[in] TRUE özellik alt öğelerini aramak için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

Dönüş Değeri

Bu yöntem başarılı olursa ilişkili özellik nesnesine yönelik bir işaretçi; aksi takdirde , NULL.

Açıklamalar

CMFCPropertyGridCtrl::CMFCPropertyGridCtrl Bir özelliğiyle ilişkilendirmek DWORD için oluşturucuyu veya CMFCPropertyGridProperty::SetData yöntemi kullanın.

CMFCPropertyGridCtrl::get_accChildCount

virtual HRESULT get_accChildCount(long* pcountChildren);

Parametreler

[in] pcountChildren\

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::get_accFocus

virtual HRESULT get_accFocus(VARIANT* pvarChild);

Parametreler

[in] pvarChild\

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::get_accHelp

virtual HRESULT get_accHelp(
    VARIANT varChild,
    BSTR* pszHelp);

Parametreler

[in] varChild
[in] pszHelp\

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::get_accHelpTopic

virtual HRESULT get_accHelpTopic(
    BSTR* pszHelpFile,
    VARIANT varChild,
    long* pidTopic);

Parametreler

[in] pszHelpFile
[in] varChild
[in] pidTopic\

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::get_accKeyboardShortcut

virtual HRESULT get_accKeyboardShortcut(
    VARIANT varChild,
    BSTR* pszKeyboardShortcut);

Parametreler

[in] varChild
[in] pszKeyboardShortcut\

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::get_accSelection

virtual HRESULT get_accSelection(VARIANT* pvarChildren);

Parametreler

[in] pvarChildren\

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::GetBkColor

Geçerli özellik kılavuzu denetiminin arka plan rengini alır.

COLORREF GetBkColor() const;

Dönüş Değeri

RGB renk değeri.

Açıklamalar

Bu yöntem, çerçevenin geçerli özellik kılavuzu denetiminin arka planını çizmek için kullandığı rengi alır. CMFCPropertyGridCtrl::GetTextColor yöntemi ön plan rengini alır.

CMFCPropertyGridCtrl::GetBoldFont

Geçerli özellik kılavuzu denetiminde kalın stilde metin çizmek için kullanılan Windows yazı tipini alır.

CFont& GetBoldFont();

Dönüş Değeri

Kalın yazı CFont tipinin özelliklerini açıklayan bir nesneye başvuru.

CMFCPropertyGridCtrl::GetCurSel

Seçili durumdaki özelliği alır.

CMFCPropertyGridProperty* GetCurSel() const;

Dönüş Değeri

Özellik kılavuzu denetiminde seçili öğeye karşılık gelen özellik nesnesi işaretçisi.

Açıklamalar

CMFCPropertyGridCtrl::GetCustomColors

Özellik kılavuzu denetim öğeleri için şu anda tanımlanmış olan özel renkleri alır.

void GetCustomColors(
    COLORREF& clrBackground,
    COLORREF& clrText,
    COLORREF& clrGroupBackground,
    COLORREF& clrGroupText,
    COLORREF& clrDescriptionBackground,
    COLORREF& clrDescriptionText,
    COLORREF& clrLine);

Parametreler

clrBackground
[out] Özellik değerlerinin arka plan rengi.

clrText
[out] Özellik adlarının ve özellik değeri metninin rengi.

clrGroupBackground
[out] Özellik grubunun arka plan rengi.

clrGroupText
[out] Özellik grubundaki metnin rengi.

clrDescriptionBackground
[out] Açıklama alanının arka plan rengi.

clrDescriptionText
[out] Açıklama alanındaki metnin rengi.

clrLine
[out] Özellikler arasında çizilen çizgilerin rengi.

Açıklamalar

CMFCPropertyGridCtrl::SetCustomColors Özel renkler ayarlamak için yöntemini kullanın.

CMFCPropertyGridCtrl::GetDescriptionHeight

Özellik kılavuzu denetiminin en altında bulunan açıklama alanının yüksekliğini alır.

int GetDescriptionHeight() const;

Dönüş Değeri

Açıklama alanının piksel cinsinden yüksekliği.

Açıklamalar

Açıklama alanının yüksekliği otomatik olarak hesaplanır ve özellik kılavuzu denetiminin yüksekliği 1/4 olarak ayarlanır.

CMFCPropertyGridCtrl::EnableDescriptionArea Açıklama alanını görüntülemek veya gizlemek için yöntemini kullanın. CMFCPropertyGridCtrl::IsDescriptionArea Açıklama alanının görüntülenip görüntülenmeyeceğini veya gizlendiğini belirlemek için yöntemini kullanın.

CMFCPropertyGridCtrl::GetDescriptionRows

Geçerli özellik kılavuzu denetiminin açıklama alanındaki satır sayısını alır.

int GetDescriptionRows() const;

Dönüş Değeri

Geçerli özellik kılavuzu denetiminin açıklama alanındaki satır sayısı.

Açıklamalar

Oluşturucu, CMFCPropertyGridCtrl::CMFCPropertyGridCtrl açıklama alanını 3 satıra başlatır.

CMFCPropertyGridCtrl::GetHeaderCtrl

Çerçevenin geçerli özellik kılavuzu denetimini görüntülemek için kullandığı iç CMFCHeaderCtrl nesneyi alır.

virtual CMFCHeaderCtrl& GetHeaderCtrl();

Dönüş Değeri

Bir nesneye CMFCHeaderCtrl başvuru.

CMFCPropertyGridCtrl::GetHeaderHeight

Özellik kılavuzu denetiminin üst bilgisinin yüksekliğini alır.

int GetHeaderHeight() const;

Dönüş Değeri

Üst bilginin piksel cinsinden yüksekliği.

Açıklamalar

CMFCPropertyGridCtrl::GetLeftColumnWidth

Her özelliğin adını içeren geçerli özellik kılavuzu denetiminin sol sütununun genişliğini alır.

int GetLeftColumnWidth() const;

Dönüş Değeri

Ad sütununun genişliği.

Açıklamalar

Özellik kılavuzu denetiminin sağ sütunu her özelliğin değerini içerir.

CMFCPropertyGridCtrl::GetListRect

Özellik kılavuzu denetiminin sınırlayıcı dikdörtgenini alır.

CRect GetListRect() const;

Dönüş Değeri

Özellik kılavuzu denetiminin sınırlayıcı dikdörtgeni. Bu dikdörtgen açıklama alanını ve üst bilgiyi içermez.

Açıklamalar

CMFCPropertyGridCtrl::GetProperty

Özellik kılavuzu denetimindeki bir öğenin belirtilen dizinine karşılık gelen özellik nesnesi işaretçisini alır.

CMFCPropertyGridProperty* GetProperty(int nIndex) const;

Parametreler

nIndex
[in] Özellik kılavuzu denetim öğesinin sıfır tabanlı dizini.

Bu yöntem, parametrenin sıfırdan küçük veya özellik sayısından nIndex büyük veya buna eşit olup olmadığını onaylar.

Dönüş Değeri

Bu yöntem başarılı olursa belirtilen dizine karşılık gelen özellik nesnesi işaretçisi; aksi takdirde , NULL.

Açıklamalar

CMFCPropertyGridCtrl::GetPropertyColumnWidth

Özellik değerlerini içeren sütunun geçerli genişliğini alır.

int GetPropertyColumnWidth() const;

Dönüş Değeri

Özellik değerlerini içeren sütunun geçerli genişliği.

Açıklamalar

Özellik kılavuzu denetiminde sağ taraftaki sütun özellik değerlerini içerir. Müşteri, değerler sütununun genişliğini değiştirmek için özellik kılavuzu denetiminin bölme kutusunu kullanabilir.

CMFCPropertyGridCtrl::GetPropertyCount

Özellik kılavuzu denetimindeki özelliklerin sayısını alır.

int GetPropertyCount() const;

Dönüş Değeri

Özellik sayısı.

Açıklamalar

CMFCPropertyGridCtrl::GetRowHeight

Özellik kılavuzu denetimindeki bir satırın yüksekliğini alır.

int GetRowHeight() const;

Dönüş Değeri

Satırın yüksekliği.

Açıklamalar

Satırın yüksekliği geçerli yazı tipi yüksekliğine artı 4 piksele eşittir.

CMFCPropertyGridCtrl::GetScrollBarCtrl

Özellik kılavuzu denetiminde kaydırma çubuğu denetiminin işaretçisini alır.

virtual CScrollBar* GetScrollBarCtrl(int nBar) const;

Parametreler

nBar
[in] Kaydırma çubuğunun yönlendirmesi( olmalıdır SB_VERT).

Dönüş Değeri

Kaydırma çubuğu nesnesinin işaretçisi veya NULL kaydırma çubuğu yoksa veya kaydırma çubuğu yönü şeklindeyse SB_HORZ.

Açıklamalar

Dikey kaydırma çubuğu denetimine doğrudan erişim elde etmek için bu yöntemi kullanın.

CMFCPropertyGridCtrl::GetTextColor

Geçerli özellik kılavuzu denetimindeki özellik öğelerinin metnini çizmek için kullanılan rengi alır.

COLORREF GetTextColor() const;

Dönüş Değeri

RGB renk değeri.

Açıklamalar

Bu yöntem, çerçevenin geçerli özellik kılavuzu denetiminin ön planını çizmek için kullandığı rengi alır. CMFCPropertyGridCtrl::GetBkColor yöntemi arka plan rengini alır.

CMFCPropertyGridCtrl::HitTest

Öğede belirtilen bir nokta varsa, özellik kılavuzu denetim öğesine karşılık gelen özellik nesnesine bir işaretçi alır. Bu yöntem ayrıca özellik kılavuzu denetiminde noktayı içeren alanı gösterir.

CMFCPropertyGridProperty* HitTest(
    CPoint pt,
    CMFCPropertyGridProperty::ClickArea* pnArea=NULL,
    BOOL bPropsOnly=FALSE) const;

Parametreler

pt
[in] İstemci koordinatlarında bir nokta.

pnArea
[in, out] Değişken işaretçisi ClickArea . Bu yöntem döndürdüğünde, değişken belirtilen noktayı içeren özellik alanını gösterir. Özellik alanı hakkında daha fazla bilgi için bkz. Açıklamalar.

bPropsOnly
[in] TRUE yalnızca özellik alanını test etmek için; FALSE belirtilen nokta özellik alanında değilse açıklama alanını test etmek için. Varsayılan değer şudur: FALSE. Açıklama alanı hakkında daha fazla bilgi için bkz. Açıklamalar.

Dönüş Değeri

bPropsOnly Parametre ise TRUE ve belirtilen nokta bir özellik alanındaysa, dönüş değeri ilgili özellik nesnesine bir işaretçidir. Ayrıca parametresi, pnArea belirtilen noktayı içeren belirli bir alana ayarlanır. Aksi takdirde, dönüş değeri ve NULL pnArea parametresi değiştirilmez.

bPropsOnly parametresi iseFALSE, dönüş değeri her zaman NULLolur. Ancak, belirtilen nokta açıklama alanındaysa parametresi pnArea olarak CMFCPropertyGridProperty::ClickDescriptionayarlanır.

Açıklamalar

Özellik alanı terimi, özellik kılavuzu denetim öğesinin ad, değer veya genişletme kutusu alanlarından herhangi birine başvurur. Açıklama alanı , özellik kılavuzu denetiminin en altındaki bölgedir. Bir özellik kılavuzu denetim öğesi seçtiğinizde, açıklama alanında ilgili özelliğin açıklaması görüntülenir.

Bu yöntem, parametrenin işaret olduğu değişkenin pnArea değerini ayarlar. Aşağıdaki tabloda olası değerler ve buna karşılık gelen alanlar listelemektedir.

Değer	Alan
ClickArea::ClickExpandBox	Özellik genişletme kutusu denetimi.
ClickArea::ClickName	Özellik adı.
ClickArea::ClickValue	Özellik değeri.
CMFCPropertyGridProperty::ClickDescription	Özellik kılavuzu denetimi açıklama alanı.

CMFCPropertyGridCtrl::Init

Bir özellik kılavuzu denetimini başlatmak için çerçeve tarafından çağrılır.

virtual void Init();

Açıklamalar

CMFCPropertyGridCtrl::InitHeader

Çerçevenin geçerli özellik kılavuzu denetimini görüntülemek için kullandığı iç CMFCHeaderCtrl nesneyi başlatır.

virtual void InitHeader();

CMFCPropertyGridCtrl::IsAlphabeticMode

Özellik kılavuzu denetiminin alfabetik modda olup olmadığını gösterir.

BOOL IsAlphabeticMode() const;

Dönüş Değeri

TRUE özellik kılavuzu denetimi alfabetik moddaysa; aksi takdirde FALSE.

Açıklamalar

Özellik kılavuzu denetimi alfabetik modda olduğunda, tüm özellikler adlarına göre alfabetik olarak sıralanır. Aksi takdirde, özellikler üst düğümleri altında gruplandırılır.

CMFCPropertyGridCtrl::SetAlphabeticMode Alfabetik modu etkinleştirmek veya devre dışı bırakmak için yöntemini kullanın.

CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip

BOOL IsAlwaysShowUserToolTip() const;

Dönüş Değeri

Açıklamalar

CMFCPropertyGridCtrl::IsDescriptionArea

Özellik kılavuzu denetiminin açıklama alanının görüntülenip görüntülenmeyeceğini gösterir.

BOOL IsDescriptionArea() const;

Dönüş Değeri

TRUE açıklama alanı görüntüleniyorsa; aksi takdirde , FALSE.

Açıklamalar

CMFCPropertyGridCtrl::EnableDescriptionArea Açıklama alanını gizlemek veya görüntülemek için yöntemini kullanın.

CMFCPropertyGridCtrl::IsGroupNameFullWidth

Her özellik grubu adının geçerli özellik kılavuzu denetiminin genişliği boyunca görüntülenip görüntülenmeyeceğini gösterir.

BOOL IsGroupNameFullWidth() const;

Dönüş Değeri

TRUE grup adları özellik kılavuzu denetiminin genişliği boyunca görüntüleniyorsa; FALSE grup adları denetimin sağ (değer) sütunu tarafından kesilirse.

Açıklamalar

Grup, bir özellik kılavuzu denetimindeki ilgili özellikler koleksiyonudur. Denetim hiyerarşik olarak görüntülenirse, grup adı grubun üstündeki satırda kategori başlığı olarak görüntülenir.

CMFCPropertyGridCtrl::IsHeaderCtrl

Üst bilgi denetiminin görüntülenip görüntülenmeyeceğini gösterir.

BOOL IsHeaderCtrl() const;

Dönüş Değeri

TRUE üst bilgi denetimi görüntüleniyorsa; aksi takdirde FALSE.

Açıklamalar

CMFCPropertyGridCtrl::EnableHeaderCtrl Üst bilgi denetimini gizlemek veya görüntülemek için yöntemini kullanın.

CMFCPropertyGridCtrl::IsMarkModifiedProperties

Özellik kılavuzu denetiminin değiştirilmiş özellikleri nasıl görüntülediğini gösterir.

BOOL IsMarkModifiedProperties() const;

Dönüş Değeri

TRUE değiştirilen özellikleri görüntülemek için kalın stil kullanılıyorsa; FALSE değiştirilen özellikleri görüntülemek için normal stil kullanılıyorsa.

Açıklamalar

CMFCPropertyGridCtrl::IsShowDragContext

Kullanıcı sütunları yeniden boyutlandırdığında çerçevenin geçerli özellik kılavuzu denetiminin ad ve değer sütunlarını yeniden çizip çizmediğini gösterir.

BOOL IsShowDragContext() const;

Dönüş Değeri

TRUE yeniden boyutlandırma işlemi sırasında çerçeve ad ve değer sütunlarını yeniden çiziyorsa; FALSE sürükleme işlemi tamamlandıktan sonra çerçeve sütunları yeniden çizerse.

Açıklamalar

Kullanıcı, sütunlar arasındaki bölme çubuğunu sürükleyerek özellik kılavuzu denetiminin ad ve değer sütunlarını yeniden boyutlandırabilir. Sürükleme bağlamı görüntülenirse, kullanıcı bölme çubuğunu sürüklediği sürece ad ve değer sütunları yeniden boyutlandırılır. Aksi takdirde, bölme çubuğu taşınır, ancak sürükleme işlemi tamamlanana kadar sütunlar yeniden çizilir.

CMFCPropertyGridCtrl::IsVSDotNetLook

Özellik kılavuzu denetiminin görünümünün Visual Studio .NET stilinde olup olmadığını gösterir.

BOOL IsVSDotNetLook() const;

Dönüş Değeri

TRUE özellik kılavuzu denetimi Visual Studio .NET stilindeyse; aksi takdirde , FALSE.

Açıklamalar

CMFCPropertyGridCtrl::SetVSDotNetLook Özellik kılavuzu denetimini Visual Studio .NET stiline ayarlamak için yöntemini kullanın.

CMFCPropertyGridCtrl::MarkModifiedProperties

Değiştirilen özelliklerin nasıl görüntüleneceğini belirtir.

void MarkModifiedProperties(
    BOOL bMark=TRUE,
    BOOL bRedraw=TRUE);

Parametreler

bMark
[in] TRUE değiştirilen özellikleri kalın stilde görüntülemek için; FALSE değiştirdiğiniz özellikleri normal stilde görüntülemek için. Varsayılan değer şudur: TRUE.

bRedraw
[in] TRUE özellik kılavuzu denetimini hemen yeniden çizmek için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

Açıklamalar

CMFCPropertyGridCtrl::OnChangeSelection

Geçerli seçim değiştirildiğinde çerçeve tarafından çağrılır.

virtual void OnChangeSelection(
    CMFCPropertyGridProperty* pNewSel,
    CMFCPropertyGridProperty* pOldSel);

Parametreler

pNewSel
[in] Yeni seçilen özelliğin işaretçisi.

pOldSel
[in] Daha önce seçilen özelliğin işaretçisi.

Açıklamalar

Bu yöntemin varsayılan uygulaması hiçbir şey yapmaz.

CMFCPropertyGridCtrl::OnClickButton

Bir özellik düğmesine tıklandığında çerçeve tarafından çağrılır.

virtual void OnClickButton(CPoint point);

Parametreler

point
[in] İstemci koordinatlarında bir nokta.

Açıklamalar

Varsayılan olarak, bu yöntem geçerli özellik değerini güncelleştirir.

CMFCPropertyGridCtrl::OnDrawBorder

Bir özellik kılavuzu denetiminin çevresine kenarlık çizmek için çerçeve tarafından çağrılır.

virtual void OnDrawBorder(CDC* pDC);

Parametreler

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

Açıklamalar

CMFCPropertyGridCtrl::OnDrawDescription

Açıklama alanını çizmek ve açıklama metnini görüntülemek için çerçeve tarafından çağrılır.

virtual void OnDrawDescription(
    CDC* pDC,
    CRect rect);

Parametreler

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

rect
[in] Açıklama alanının nereye çizildiğini belirten dikdörtgen.

Açıklamalar

CMFCPropertyGridCtrl::EnableDescriptionArea Açıklama alanını görüntülemek için yöntemini kullanın.

CMFCPropertyGridCtrl::OnDrawList

Özellik kılavuzu denetimindeki özelliklerin listesini görüntülemek için çerçeve tarafından çağrılır.

virtual void OnDrawList(CDC* pDC);

Parametreler

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

Açıklamalar

CMFCPropertyGridCtrl::OnDrawProperty

Bir özelliği görüntülemek için çerçeve tarafından çağrılır.

virtual int OnDrawProperty(
    CDC* pDC,
    CMFCPropertyGridProperty* pProp) const;

Parametreler

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

pProp
[in] Özellik nesnesinin işaretçisi.

Dönüş Değeri

TRUE bu yöntem başarılı olursa; aksi takdirde , FALSE.

Açıklamalar

CMFCPropertyGridCtrl::OnPropertyChanged

Bir özelliğin değeri değiştirildiğinde çerçeve tarafından çağrılır.

virtual void OnPropertyChanged(CMFCPropertyGridProperty* pProp) const;

Parametreler

pProp
[in] Değeri değiştirilmiş bir özellik nesnesinin işaretçisi.

Açıklamalar

Varsayılan olarak, bu yöntem iletiyi özellik kılavuzu denetiminin sahibine gönderir AFX_WM_PROPERTY_CHANGED .

CMFCPropertyGridCtrl::OnSelectCombo

Birleşik giriş kutusu denetimi içeren bir özellik seçildiğinde çerçeve tarafından çağrılır.

void OnSelectCombo();

Açıklamalar

CMFCPropertyGridCtrl::RemoveAll

Bir özellik kılavuzu denetiminden tüm özellik nesnelerini kaldırır.

void RemoveAll();

Açıklamalar

CMFCPropertyGridCtrl::ResetOriginalValues

Tüm özelliklerin özgün değerlerini geri yükler.

void ResetOriginalValues(BOOL bRedraw=TRUE);

Parametreler

bRedraw
[in] TRUE özellik listesini yeniden çizmek için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

Açıklamalar

CMFCPropertyGridCtrl::SetAlphabeticMode

Alfabetik modu ayarlar veya sıfırlar.

void SetAlphabeticMode(BOOL bSet=TRUE);

Parametreler

bSet
[in] TRUE alfabetik modu ayarlamak için; FALSE alfabetik modu sıfırlayın. Varsayılan değer şudur: TRUE.

Açıklamalar

Özellik kılavuzu denetimi alfabetik modda olduğunda, denetim içerdiği tüm özellikleri kendi özellik adına göre sıralar.

CMFCPropertyGridCtrl::SetBoolLabels

Boole etiketlerinin metnini belirtir.

void SetBoolLabels(
    LPCTSTR lpszTrue,
    LPCTSTR lpszFalse);

Parametreler

lpszTrue
[in] True Boole değeri için görüntülenecek metin dizesi.

lpszFalse
[in] False Boole değeri için görüntülenecek metin dizesi.

Açıklamalar

CMFCPropertyGridCtrl::SetCurSel

Özellik kılavuzu denetiminde bir özellik seçer.

void SetCurSel(
    CMFCPropertyGridProperty* pProp,
    BOOL bRedraw=TRUE);

Parametreler

pProp
[in] Özellik nesnesinin işaretçisi.

bRedraw
[in] TRUE özellik kılavuzu denetimini hemen yeniden çizmek için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

Açıklamalar

Özellik kılavuzu denetiminde geçerli öğenin seçimini iptal etmek ve ardından belirtilen özelliğe karşılık gelen öğeyi seçmek için bu yöntemi kullanın.

CMFCPropertyGridCtrl::SetCustomColors

Özellik kılavuzu denetiminin çeşitli öğeleri için özel renkleri belirtir.

void SetCustomColors(
    COLORREF clrBackground,
    COLORREF clrText,
    COLORREF clrGroupBackground,
    COLORREF clrGroupText,
    COLORREF clrDescriptionBackground,
    COLORREF clrDescriptionText,
    COLORREF clrLine);

Parametreler

clrBackground
[in] Özellik değerlerinin arka plan rengi.

clrText
[in] Özellik adlarının ve özellik değeri metninin rengi.

clrGroupBackground
[in] Özellik grubunun arka plan rengi.

clrGroupText
[in] Özellik grubunun yeni metin rengi.

clrDescriptionBackground
[in] Açıklama alanının arka plan rengi.

clrDescriptionText
[in] Açıklama alanındaki metnin rengi.

clrLine
[in] Özellikler arasında çizilen çizgilerin rengi.

Açıklamalar

Herhangi bir parametre için, özellik kılavuzu denetiminin ((COLORREF)-1) bu öğesi için varsayılan rengin kullanılacağı renk değerini belirtin.

Belirli bir özelliğin görünümünü özelleştirmek için sınıfından CMFCPropertyGridProperty bir sınıf türetin ve ardından , CMFCPropertyGridProperty::OnDrawValue, CMFCPropertyGridProperty::OnDrawExpandBoxve CMFCPropertyGridProperty::OnDrawButton yöntemlerini geçersiz kılınCMFCPropertyGridProperty::OnDrawName.

CMFCPropertyGridCtrl::SetDescriptionRows

Geçerli özellik kılavuzu denetiminin açıklama bölümünde görüntülenecek satır sayısını belirtir.

void SetDescriptionRows(int nDescRows);

Parametreler

nDescRows
[in] Özellik açıklamasında görüntülenecek satır sayısı.

CMFCPropertyGridCtrl::SetGroupNameFullWidth

Geçerli özellik kılavuzu denetimindeki bir özellik grubu için kategori adının tam genişliğinin görüntülenip görüntülenmeyeceğini belirtir.

void SetGroupNameFullWidth(
    BOOL bGroupNameFullWidth = TRUE,
    BOOL bRedraw = TRUE);

Parametreler

bGroupNameFullWidth
[in] TRUE özellik adı sütununun genişliği ne olursa olsun kategori adının tam genişliğini görüntülemek için. FALSE kategori adının genişliğini özellik adı sütununun genişliğiyle sınırlamak için. Varsayılan değer şudur: TRUE.

bRedraw
[in] TRUE özellik kılavuzu denetimini hemen güncelleştirmek için; FALSE bir sonraki yeniden çizim olayı gerçekleştiğinde denetimi güncelleştirmek için. Varsayılan değer şudur: TRUE.

Açıklamalar

Özellik kılavuzu denetimi, yeniden boyutlandırılabilir özellik adı sütunundan ve özellik değeri sütunundan oluşur. Ad sütununun sonu aynı zamanda değer sütununun başlangıcıdır. Sütunları yeniden boyutlandırmak için, kenarlıkları sütunlar arasında sürükleyin.

Grup adı ve kategori adı terimleri bu yöntemde birbirinin yerine kullanılır. Kategori adı, bir dizi ilgili özellik ve değere yönelen bir satırda görüntülenir. Bu yöntem, özellik adı sütununun genişliğinin görüntülenen kategori adının genişliğini de belirtip belirtmeyeceğini belirtir.

CMFCPropertyGridCtrl::SetListDelimiter

Özellik değerleri listesinde sınırlayıcı olarak kullanılan bir karakteri tanımlar.

void SetListDelimiter(TCHAR c);

Parametreler

c
[in] Sınırlayıcı görevi görecek bir karakter.

Açıklamalar

Oluşturucuda kullanılan CMFCPropertyGridProperty::CMFCPropertyGridProperty özellik değerleri listesinde sınırlayıcı karakteri tanımlamak için bu yöntemi kullanın. Bu oluşturucuda parametresini bIsValueList olarak TRUEayarlayın.

Oluşturucu varsayılan CMFCPropertyGridCtrl::CMFCPropertyGridCtrl olarak sınırlayıcı karakterini virgül (',') olarak ayarlar.

CMFCPropertyGridCtrl::SetShowDragContext

Kullanıcı sütunları yeniden boyutlandırdığında çerçevenin geçerli özellik kılavuzu denetiminin ad ve değer sütunlarını yeniden çizip çizmeyeceğini belirtir.

void SetShowDragContext(BOOL bShowDragContext = TRUE);

Parametreler

bShowDragContext
[in] TRUE yeniden boyutlandırma işlemi sırasında ad ve değer sütunlarını yeniden çizmek için; FALSE sürükleme işlemi tamamlandıktan sonra sütunları yeniden çizmek için. Varsayılan değer şudur: TRUE.

Açıklamalar

Kullanıcı, sütunlar arasındaki bölme çubuğunu sürükleyerek özellik kılavuzu denetiminin ad ve değer sütunlarını yeniden boyutlandırabilir. Sürükleme bağlamı görüntülenirse, kullanıcı bölme çubuğunu sürüklediği sürece ad ve değer sütunları yeniden boyutlandırılır. Aksi takdirde, bölme çubuğu taşınır, ancak sürükleme işlemi tamamlanana kadar sütunlar yeniden çizilir.

CMFCPropertyGridCtrl::SetVSDotNetLook

Özellik kılavuzu denetiminin görünümünü Visual Studio .NET'te kullanılan stile ayarlar.

void SetVSDotNetLook(BOOL bSet=TRUE);

Parametreler

bSet
[in] TRUE özellik kılavuzu denetimini Visual Studio .NET'te kullanılan stile ayarlamak için; aksi takdirde , FALSE. Varsayılan değer şudur: TRUE.

Açıklamalar

CMFCPropertyGridCtrl::UpdateColor

Seçili durumdaki renk özelliğinin renk değerini ayarlar.

virtual void UpdateColor(COLORREF color);

Parametreler

color
[in] RGB renk değeri.

Açıklamalar

Özellik kılavuzu denetiminin seçili durumdaki özelliği bir renk özelliği değilse bu yöntem hata ayıklama modunda onaylar.

CMFCPropertyGridCtrl::ValidateItemData

Özellik verilerini doğrulamak için çerçeve tarafından çağrılır.

virtual BOOL ValidateItemData(CMFCPropertyGridProperty* pProp);

Parametreler

pProp
[in] Bir özelliğin işaretçisi. Bu parametre kullanılmaz.

Dönüş Değeri

Her zaman TRUE.

Açıklamalar

yöntemi, CMFCPropertyGridCtrl::EndEditItem verileri doğrulamak için bu yöntemi çağırır. Varsayılan olarak, bu yöntem parametresini pProp kullanmaz ve dönüş değeri her zaman TRUEşeklindedir.

Bu yöntemi geçersiz kılarsanız, belirtilen özellik verileri geçerliyse döndürebilirsiniz TRUE . Aksi takdirde döndürebilirsiniz FALSE. Bu durumda çerçeve özelliği güncelleştirmez.

Ayrıca bkz.

Hiyerarşi Grafiği
Sınıflar