COlePropertyPage Sınıfı

Özel denetimin özelliklerini bir iletişim kutusuna benzer şekilde grafik arabirimde görüntülemek için kullanılır.

Sözdizimi

class AFX_NOVTABLE COlePropertyPage : public CDialog

Üyeler

Ortak Oluşturucular

Veri Akışı Adı	Açıklama
COlePropertyPage::COlePropertyPage	Bir COlePropertyPage nesne oluşturur.

Genel Yöntemler

Veri Akışı Adı	Açıklama
COlePropertyPage::GetControlStatus	Kullanıcının denetimdeki değeri değiştirip değiştirmediğini gösterir.
COlePropertyPage::GetObjectArray	Özellik sayfası tarafından düzenlenen nesne dizisini döndürür.
COlePropertyPage::GetPageSite	Özellik sayfasının IPropertyPageSite arabirimine bir işaretçi döndürür.
COlePropertyPage::IgnoreApply	Hangi denetimlerin Uygula düğmesini etkinleştirmediğini belirler.
COlePropertyPage::IsModified	Kullanıcının özellik sayfasını değiştirip değiştirmediğini gösterir.
COlePropertyPage::OnEditProperty	Kullanıcı bir özelliği düzenlediğinde çerçeve tarafından çağrılır.
COlePropertyPage::OnHelp	Kullanıcı yardım çağırdığında çerçeve tarafından çağrılır.
COlePropertyPage::OnInitDialog	Özellik sayfası başlatıldığında çerçeve tarafından çağrılır.
COlePropertyPage::OnObjectsChanged	Yeni özelliklere sahip başka bir OLE denetimi seçildiğinde çerçeve tarafından çağrılır.
COlePropertyPage::OnSetPageSite	Özellik çerçevesi sayfanın sitesini sağladığında çerçeve tarafından çağrılır.
COlePropertyPage::SetControlStatus	Kullanıcının denetimdeki değeri değiştirip değiştirmediğini belirten bir bayrak ayarlar.
COlePropertyPage::SetDialogResource	Özellik sayfasının iletişim kutusu kaynağını ayarlar.
COlePropertyPage::SetHelpInfo	Özellik sayfasının kısa yardım metnini, yardım dosyasının adını ve yardım bağlamını ayarlar.
COlePropertyPage::SetModifiedFlag	Kullanıcının özellik sayfasını değiştirip değiştirmediğini belirten bir bayrak ayarlar.
COlePropertyPage::SetPageName	Özellik sayfasının adını (resim yazısı) ayarlar.

Açıklamalar

Örneğin özellik sayfası, kullanıcının denetimin resim yazısı özelliğini görüntülemesine ve değiştirmesine olanak tanıyan bir düzenleme denetimi içerebilir.

Her özel veya hisse senedi denetimi özelliği, denetimin kullanıcısının geçerli özellik değerini görüntülemesine ve gerekirse bu değeri değiştirmesine olanak tanıyan bir iletişim kutusu denetimine sahip olabilir.

kullanma COlePropertyPagehakkında daha fazla bilgi için ActiveX Denetimleri: Özellik Sayfaları makalesine bakın.

Devralma Hiyerarşisi

CObject

CCmdTarget

CWnd

CDialog

COlePropertyPage

Gereksinimler

Üst bilgi: afxctl.h

COlePropertyPage::COlePropertyPage

Bir COlePropertyPage nesne oluşturur.

COlePropertyPage(
    UINT idDlg,
    UINT idCaption);

Parametreler

idDlg
İletişim kutusu şablonunun Kaynak Kimliği.

idCaption
Özellik sayfasının resim yazısının kaynak kimliği.

Açıklamalar

öğesinin bir alt sınıfını COlePropertyPageuyguladığınızda, alt sınıfınızın oluşturucusunu kullanarak özellik sayfasının temel aldığı iletişim kutusu şablonu kaynağını ve resim yazısını içeren dize kaynağını tanımlaması gerekir COlePropertyPage .

COlePropertyPage::GetControlStatus

Kullanıcının belirtilen kaynak kimliğiyle özellik sayfası denetiminin değerini değiştirip değiştirmediğini belirler.

BOOL GetControlStatus(UINT nID);

Parametreler

Nıd
Özellik sayfası denetiminin kaynak kimliği.

Dönüş Değeri

Denetim değeri değiştirildiyse TRUE; aksi takdirde YANLIŞ.

COlePropertyPage::GetObjectArray

Özellik sayfası tarafından düzenlenen nesne dizisini döndürür.

LPDISPATCH* GetObjectArray(ULONG* pnObjects);

Parametreler

pnObjects
Sayfa tarafından düzenlenen nesne sayısını alacak işaretsiz bir uzun tamsayı işaretçisi.

Dönüş Değeri

Özellik sayfasındaki her denetimin IDispatch özelliklerine erişmek için kullanılan bir işaretçi dizisi işaretçisi. Çağıranın bu arabirim işaretçilerini serbest bırakmaması gerekir.

Açıklamalar

Her özellik sayfası nesnesi, sayfa tarafından düzenlenen nesnelerin arabirimlerine yönelik bir işaretçi IDispatch dizisi tutar. Bu işlev, pnObjects bağımsız değişkenini bu dizideki öğe sayısına ayarlar ve dizinin ilk öğesine bir işaretçi döndürür.

COlePropertyPage::GetPageSite

Özellik sayfasının IPropertyPageSite arabirimine bir işaretçi alır.

LPPROPERTYPAGESITE GetPageSite();

Dönüş Değeri

Özellik sayfasının arabiriminin işaretçisi IPropertyPageSite .

Açıklamalar

Denetimler ve kapsayıcılar, kullanıcıların denetim özelliklerine göz atabilmesi ve düzenleyebilmesi için işbirliği sağlar. Denetim, her biri kullanıcının ilgili bir özellik kümesini düzenlemesine olanak tanıyan bir OLE nesnesi olan özellik sayfaları sağlar. Kapsayıcı, özellik sayfalarını görüntüleyen bir özellik çerçevesi sağlar. Her sayfa için özellik çerçevesi, arabirimi destekleyen IPropertyPageSite bir sayfa sitesi sağlar.

COlePropertyPage::IgnoreApply

Hangi denetimlerin Uygula düğmesini etkinleştirmediğini belirler.

void IgnoreApply(UINT nID);

Parametreler

Nıd
Yoksayılacak denetimin kimliği.

Açıklamalar

Özellik sayfasının Uygula düğmesi yalnızca özellik sayfası denetimlerinin değerleri değiştirildiğinde etkinleştirilir. Değerleri değiştiğinde Uygula düğmesinin etkinleştirilmesine neden olmayan denetimleri belirtmek için bu işlevi kullanın.

COlePropertyPage::IsModified

Kullanıcının özellik sayfasındaki değerleri değiştirip değiştirmediğini belirler.

BOOL IsModified();

Dönüş Değeri

Özellik sayfası değiştirildiyse TRUE.

COlePropertyPage::OnEditProperty

Belirli bir özellik düzenlendiğinde çerçeve bu işlevi çağırır.

virtual BOOL OnEditProperty(DISPID dispid);

Parametreler

dispid
Düzenlenmekte olan özelliğin dağıtım kimliği.

Dönüş Değeri

Varsayılan uygulama FALSE döndürür. Bu işlevin geçersiz kılmaları TRUE döndürmelidir.

Açıklamalar

Odağı sayfadaki uygun denetime ayarlamak için geçersiz kılabilirsiniz. Varsayılan uygulama hiçbir şey yapmaz ve YANLIŞ döndürür.

COlePropertyPage::OnHelp

Kullanıcı çevrimiçi yardım istediğinde çerçeve bu işlevi çağırır.

virtual BOOL OnHelp(LPCTSTR lpszHelpDir);

Parametreler

lpszHelpDir
Özellik sayfasının yardım dosyasını içeren dizin.

Dönüş Değeri

Varsayılan uygulama FALSE döndürür.

Açıklamalar

Kullanıcı yardıma eriştiğinde özellik sayfanızın herhangi bir özel eylem gerçekleştirmesi gerekiyorsa bunu geçersiz kılın. Varsayılan uygulama hiçbir şey yapmaz ve YANLIŞ değerini döndürür ve bu da çerçeveye WinHelp'i çağırmasını sağlar.

COlePropertyPage::OnInitDialog

Özellik sayfasının iletişim kutusu başlatıldığında çerçeve bu işlevi çağırır.

virtual BOOL OnInitDialog();

Dönüş Değeri

Varsayılan uygulama FALSE döndürür.

Açıklamalar

İletişim kutusu başlatıldığında özel bir eylem gerekiyorsa, bunu geçersiz kılın. Varsayılan uygulama FALSE'ı çağırır CDialog::OnInitDialog ve döndürür.

COlePropertyPage::OnObjectsChanged

Yeni özelliklere sahip başka bir OLE denetimi seçildiğinde çerçeve tarafından çağrılır.

virtual void OnObjectsChanged();

Açıklamalar

Geliştirici ortamında ole denetiminin özelliklerini görüntülerken, özellik sayfalarını görüntülemek için modsuz bir iletişim kutusu kullanılır. Başka bir denetim seçilirse, yeni özellik kümesi için farklı bir özellik sayfaları kümesi görüntülenmelidir. Çerçeve, özellik sayfasına değişikliği bildirmek için bu işlevi çağırır.

Bu eylemin bildirimini almak ve özel eylemleri gerçekleştirmek için bu işlevi geçersiz kılın.

COlePropertyPage::OnSetPageSite

Özellik çerçevesi özellik sayfasının sayfa sitesini sağladığında çerçeve bu işlevi çağırır.

virtual void OnSetPageSite();

Açıklamalar

Varsayılan uygulama, sayfanın resim yazısını yükler ve iletişim kutusu kaynağından sayfanın boyutunu belirlemeye çalışır. Özellik sayfanız başka bir eylem gerektiriyorsa bu işlevi geçersiz kılın; geçersiz kılmanız temel sınıf uygulamasını çağırmalıdır.

COlePropertyPage::SetControlStatus

Özellik sayfası denetiminin durumunu değiştirir.

BOOL SetControlStatus(
    UINT nID,
    BOOL bDirty);

Parametreler

Nıd
Özellik sayfası denetiminin kimliğini içerir.

bDirty
Özellik sayfasının bir alanının değiştirilip değiştirilmediğini belirtir. Alan değiştirildiyse TRUE, değiştirilmediyse YANLIŞ olarak ayarlayın.

Dönüş Değeri

TRUE, belirtilen denetim ayarlandıysa; aksi takdirde YANLIŞ.

Açıklamalar

Özellik sayfası kapatıldığında veya Uygula düğmesi seçildiğinde özellik sayfası denetiminin durumu kirliyse, denetimin özelliği uygun değerle güncelleştirilir.

COlePropertyPage::SetDialogResource

Özellik sayfasının iletişim kutusu kaynağını ayarlar.

void SetDialogResource(HGLOBAL hDialog);

Parametreler

hDialog
Özellik sayfasının iletişim kutusu kaynağının tanıtıcısı.

COlePropertyPage::SetHelpInfo

Araç ipucu bilgilerini, yardım dosya adını ve özellik sayfanızın yardım bağlamını belirtir.

void SetHelpInfo(
    LPCTSTR lpszDocString,
    LPCTSTR lpszHelpFile = NULL,
    DWORD dwHelpContext = 0);

Parametreler

lpszDocString
Durum çubuğunda veya başka bir konumda görüntülenmek üzere kısa yardım bilgilerini içeren dize.

lpszHelpFile
Özellik sayfasının yardım dosyasının adı.

dwHelpContext
Özellik sayfası için yardım bağlamı.

COlePropertyPage::SetModifiedFlag

Kullanıcının özellik sayfasını değiştirip değiştirmediğini gösterir.

void SetModifiedFlag(BOOL bModified = TRUE);

Parametreler

bModified
Özellik sayfasının değiştirilen bayrağı için yeni değeri belirtir.

COlePropertyPage::SetPageName

Özellik sayfasının adını ayarlar; özellik çerçevesi genellikle sayfanın sekmesinde görüntülenir.

void SetPageName(LPCTSTR lpszPageName);

Parametreler

lpszPageName
Özellik sayfasının adını içeren bir dizenin işaretçisi.

Ayrıca bkz.

MFC Örnek CIRC3
MFC Örnek TESTHELP
CDialog Sınıfı
Hiyerarşi Grafiği
CDialog Sınıfı