COlePropertyPage Sınıfı
Özel denetimin özelliklerini bir iletişim kutusuna benzer şekilde grafik arabirimde görüntülemek için kullanılır.
class AFX_NOVTABLE COlePropertyPage : public CDialog
Veri Akışı Adı | Açıklama |
---|---|
COlePropertyPage::COlePropertyPage | Bir COlePropertyPage nesne oluşturur. |
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. |
Ö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 COlePropertyPage
hakkında daha fazla bilgi için ActiveX Denetimleri: Özellik Sayfaları makalesine bakın.
COlePropertyPage
Üst bilgi: afxctl.h
Bir COlePropertyPage
nesne oluşturur.
COlePropertyPage(
UINT idDlg,
UINT idCaption);
idDlg
İletişim kutusu şablonunun Kaynak Kimliği.
idCaption
Özellik sayfasının resim yazısının kaynak kimliği.
öğesinin bir alt sınıfını COlePropertyPage
uyguladığı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
.
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);
Nıd
Özellik sayfası denetiminin kaynak kimliği.
Denetim değeri değiştirildiyse TRUE; aksi takdirde YANLIŞ.
Özellik sayfası tarafından düzenlenen nesne dizisini döndürür.
LPDISPATCH* GetObjectArray(ULONG* pnObjects);
pnObjects
Sayfa tarafından düzenlenen nesne sayısını alacak işaretsiz bir uzun tamsayı işaretçisi.
Ö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.
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.
Özellik sayfasının IPropertyPageSite
arabirimine bir işaretçi alır.
LPPROPERTYPAGESITE GetPageSite();
Özellik sayfasının arabiriminin işaretçisi IPropertyPageSite
.
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.
Hangi denetimlerin Uygula düğmesini etkinleştirmediğini belirler.
void IgnoreApply(UINT nID);
Nıd
Yoksayılacak denetimin kimliği.
Ö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.
Kullanıcının özellik sayfasındaki değerleri değiştirip değiştirmediğini belirler.
BOOL IsModified();
Özellik sayfası değiştirildiyse TRUE.
Belirli bir özellik düzenlendiğinde çerçeve bu işlevi çağırır.
virtual BOOL OnEditProperty(DISPID dispid);
dispid
Düzenlenmekte olan özelliğin dağıtım kimliği.
Varsayılan uygulama FALSE döndürür. Bu işlevin geçersiz kılmaları TRUE döndürmelidir.
Odağı sayfadaki uygun denetime ayarlamak için geçersiz kılabilirsiniz. Varsayılan uygulama hiçbir şey yapmaz ve YANLIŞ döndürür.
Kullanıcı çevrimiçi yardım istediğinde çerçeve bu işlevi çağırır.
virtual BOOL OnHelp(LPCTSTR lpszHelpDir);
lpszHelpDir
Özellik sayfasının yardım dosyasını içeren dizin.
Varsayılan uygulama FALSE döndürür.
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.
Özellik sayfasının iletişim kutusu başlatıldığında çerçeve bu işlevi çağırır.
virtual BOOL OnInitDialog();
Varsayılan uygulama FALSE döndürür.
İ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.
Yeni özelliklere sahip başka bir OLE denetimi seçildiğinde çerçeve tarafından çağrılır.
virtual void OnObjectsChanged();
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.
Özellik çerçevesi özellik sayfasının sayfa sitesini sağladığında çerçeve bu işlevi çağırır.
virtual void OnSetPageSite();
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.
Özellik sayfası denetiminin durumunu değiştirir.
BOOL SetControlStatus(
UINT nID,
BOOL bDirty);
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.
TRUE, belirtilen denetim ayarlandıysa; aksi takdirde YANLIŞ.
Ö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.
Özellik sayfasının iletişim kutusu kaynağını ayarlar.
void SetDialogResource(HGLOBAL hDialog);
hDialog
Özellik sayfasının iletişim kutusu kaynağının tanıtıcısı.
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);
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ı.
Kullanıcının özellik sayfasını değiştirip değiştirmediğini gösterir.
void SetModifiedFlag(BOOL bModified = TRUE);
bModified
Özellik sayfasının değiştirilen bayrağı için yeni değeri belirtir.
Özellik sayfasının adını ayarlar; özellik çerçevesi genellikle sayfanın sekmesinde görüntülenir.
void SetPageName(LPCTSTR lpszPageName);
lpszPageName
Özellik sayfasının adını içeren bir dizenin işaretçisi.
MFC Örnek CIRC3
MFC Örnek TESTHELP
CDialog Sınıfı
Hiyerarşi Grafiği
CDialog Sınıfı