COlePropertiesDialog Sınıfı
Windows ortak OLE Nesne Özellikleri iletişim kutusunu kapsüller.
Sözdizimi
class COlePropertiesDialog : public COleDialog
Üyeler
Ortak Oluşturucular
| Veri Akışı Adı | Açıklama |
|---|---|
| COlePropertiesDialog::COlePropertiesDialog | Bir COlePropertiesDialog nesne oluşturur. |
Genel Yöntemler
| Veri Akışı Adı | Açıklama |
|---|---|
| COlePropertiesDialog::D oModal | İletişim kutusunu görüntüler ve kullanıcının seçim yapmasına izin verir. |
| COlePropertiesDialog::OnApplyScale | Belge öğesinin ölçeklendirmesi değiştiğinde çerçeve tarafından çağrılır. |
Ortak Veri Üyeleri
| Veri Akışı Adı | Açıklama |
|---|---|
| COlePropertiesDialog::m_gp | Bir nesnenin "Genel" sayfasını başlatmak için kullanılan yapı COlePropertiesDialog . |
| COlePropertiesDialog::m_lp | Bir nesnenin "Bağlantı" sayfasını başlatmak için kullanılan yapı COlePropertiesDialog . |
| COlePropertiesDialog::m_op | Nesneyi başlatmak COlePropertiesDialog için kullanılan bir yapı. |
| COlePropertiesDialog::m_psh | Ek özel özellik sayfaları eklemek için kullanılan bir yapı. |
| COlePropertiesDialog::m_vp | Bir nesnenin "Görünüm" sayfasını özelleştirmek için kullanılan yapı COlePropertiesDialog . |
Açıklamalar
Yaygın OLE Nesne Özellikleri iletişim kutuları, OLE belge öğesinin özelliklerini Windows standartlarıyla tutarlı bir şekilde görüntülemek ve değiştirmek için kolay bir yol sağlar. Bu özellikler arasında belge öğesiyle temsil edilen dosyayla ilgili bilgiler, simgeyi ve görüntü ölçeklendirmeyi görüntüleme seçenekleri ve öğenin bağlantısıyla ilgili bilgiler (öğe bağlıysa) bulunur.
Bir COlePropertiesDialog nesneyi kullanmak için önce oluşturucuyu COlePropertiesDialog kullanarak nesnesini oluşturun. İletişim kutusu oluşturulduktan sonra, iletişim kutusunu görüntülemek ve kullanıcının öğenin özelliklerini değiştirmesine izin vermek için üye işlevini çağırın DoModal . DoModal kullanıcının Tamam (IDOK) veya İptal (IDCANCEL) düğmesini seçerek seçmediğini döndürür. Tamam ve İptal düğmelerine ek olarak Uygula düğmesi de vardır. Kullanıcı Uygula'yı seçtiğinde, belge öğesinin özelliklerinde yapılan tüm değişiklikler öğeye uygulanır ve görüntüsü otomatik olarak güncelleştirilir, ancak etkin kalır.
m_psh veri üyesi bir PROPSHEETHEADER yapıya işaretçidir ve çoğu durumda buna açıkça erişmeniz gerekmez. Bir özel durum, varsayılan Genel, Görünüm ve Bağlantı sayfalarının ötesinde ek özellik sayfalarına ihtiyacınız olmasıdır. Bu durumda, üye işlevini çağırmadan DoModal önce veri üyesini m_psh özel sayfalarınızı içerecek şekilde değiştirebilirsiniz.
OLE iletişim kutuları hakkında daha fazla bilgi için OLE'de İletişim Kutuları makalesine bakın.
Devralma Hiyerarşisi
COlePropertiesDialog
Gereksinimler
Üst bilgi: afxodlgs.h
COlePropertiesDialog::COlePropertiesDialog
Bir COlePropertiesDialog nesnesi oluşturur.
COlePropertiesDialog(
COleClientItem* pItem,
UINT nScaleMin = 10,
UINT nScaleMax = 500,
CWnd* pParentWnd = NULL);
Parametreler
pItem
Özelliklerine erişilen belge öğesinin işaretçisi.
nScaleMin
Belge öğesi görüntüsü için en düşük ölçeklendirme yüzdesi.
nScaleMax
Belge öğesi görüntüsü için en yüksek ölçeklendirme yüzdesi.
pParentWnd
İletişim kutusunun üst veya sahip işaretçisi.
Açıklamalar
Belge öğeleriniz için ölçeklendirme uygulamak için ortak OLE Nesne Özellikleri iletişim sınıfınızı öğesinden COlePropertiesDialog türetin. Bu sınıfın bir örneği tarafından uygulanan iletişim kutuları, belge öğesinin ölçeklendirilme işlemini desteklemez.
Varsayılan olarak, ortak OLE Nesne Özellikleri iletişim kutusunda üç varsayılan sayfa vardır:
Genel
Bu sayfa, seçili belge öğesi tarafından temsil edilen dosyanın sistem bilgilerini içerir. Bu sayfadan, kullanıcı seçili öğeyi başka bir türe dönüştürebilir.
Görünüm
Bu sayfa, öğeyi görüntüleme, simgeyi değiştirme ve resmin ölçeklendirmesini değiştirme seçeneklerini içerir.
Bağlantı
Bu sayfa, bağlı öğenin konumunu değiştirme ve bağlantılı öğeyi güncelleştirme seçeneklerini içerir. Kullanıcı bu sayfadan seçilen öğenin bağlantısını kesebilir.
Varsayılan olarak sağlananların ötesine sayfa eklemek için türetilmiş sınıfınızın COlePropertiesDialogoluşturucusndan çıkmadan önce m_psh üye değişkenini değiştirin. Bu, oluşturucunun COlePropertiesDialog gelişmiş bir uygulamasıdır.
COlePropertiesDialog::D oModal
Windows ortak OLE Nesne Özellikleri iletişim kutusunu görüntülemek ve kullanıcının belge öğesinin çeşitli özelliklerini görüntülemesine ve/veya değiştirmesine izin vermek için bu üye işlevini çağırın.
virtual INT_PTR DoModal();
Dönüş Değeri
Başarılı olursa IDOK veya IDCANCEL; aksi takdirde 0. IDOK ve IDCANCEL, kullanıcının Tamam mı yoksa İptal düğmesini mi seçtiğini gösteren sabitlerdir.
IDCANCEL döndürülürse, bir hata oluşup oluşmadığını belirlemek için Windows CommDlgExtendedError işlevini çağırabilirsiniz.
COlePropertiesDialog::m_gp
OLE Nesne Özellikleri iletişim kutusunun Genel sayfasını başlatmak için kullanılan OLEUIGNRLPROPS türünde bir yapı.
OLEUIGNRLPROPS m_gp;
Açıklamalar
Bu sayfa bir eklemenin türünü ve boyutunu gösterir ve kullanıcının Dönüştür iletişim kutusuna erişmesine izin verir. Bu sayfada, nesne bir bağlantıysa bağlantı hedefi de gösterilir.
Yapı hakkında OLEUIGNRLPROPS daha fazla bilgi için bkz. Windows SDK' sı.
COlePropertiesDialog::m_lp
OLE NESNE Özellikleri iletişim kutusunun Bağlantı sayfasını başlatmak için kullanılan OLEUILINKPROPS türünde bir yapı.
OLEUILINKPROPS m_lp;
Açıklamalar
Bu sayfa, bağlı öğenin konumunu gösterir ve kullanıcının öğe bağlantısını güncelleştirmesine veya kesmesine izin verir.
Yapı hakkında OLEUILINKPROPS daha fazla bilgi için bkz. Windows SDK' sı.
COlePropertiesDialog::m_op
Ortak OLE Nesne Özellikleri iletişim kutusunu başlatmak için kullanılan OLEUIOBJECTPROPS türünde bir yapı.
OLEUIOBJECTPROPS m_op;
Açıklamalar
Bu yapı Genel, Bağlantı ve Görünüm sayfalarını başlatmak için kullanılan üyeleri içerir.
Daha fazla bilgi için bkz. Windows SDK'sında OLEUIOBJECTPROPS ve OLEUILINKPROPS yapıları.
COlePropertiesDialog::m_psh
Üyeleri iletişim kutusu nesnesinin özelliklerini depolayan PROPSHEETHEADER türünde bir yapı.
PROPSHEETHEADER m_psh;
Açıklamalar
Nesneyi COlePropertiesDialog oluşturdıktan sonra, üye işlevini çağırmadan DoModal önce iletişim kutusunun çeşitli yönlerini ayarlamak için kullanabilirsinizm_psh.
Veri üyesini m_psh doğrudan değiştirirseniz, tüm varsayılan davranışları geçersiz kılarsınız.
Yapı hakkında PROPSHEETHEADER daha fazla bilgi için bkz. Windows SDK' sı.
COlePropertiesDialog::m_vp
OLE Nesne Özellikleri iletişim kutusunun Görünüm sayfasını başlatmak için kullanılan OLEUIVIEWPROPS türünde bir yapı.
OLEUIVIEWPROPS m_vp;
Açıklamalar
Bu sayfa kullanıcının nesnenin "içerik" ve "ikonik" görünümleri arasında geçiş yapmasına ve kapsayıcı içindeki ölçeklendirmesini değiştirmesine olanak tanır. Ayrıca, nesne simge olarak görüntülenirken kullanıcının Simgeyi Değiştir iletişim kutusuna erişmesine de olanak tanır.
Yapı hakkında OLEUIVIEWPROPS daha fazla bilgi için bkz. Windows SDK' sı.
COlePropertiesDialog::OnApplyScale
Ölçeklendirme değeri değiştiğinde ve Tamam veya Uygula seçildiğinde çerçeve tarafından çağrılır.
virtual BOOL OnApplyScale(
COleClientItem* pItem,
int nCurrentScale,
BOOL bRelativeToOrig);
Parametreler
pItem
Özelliklerine erişilen belge öğesinin işaretçisi.
nCurrentScale
İletişim kutusu ölçeğinin sayısal değeri.
bRelativeToOrig
Ölçeklendirmenin belge öğesinin özgün boyutuna uygulanıp uygulanmayacağını gösterir.
Dönüş Değeri
İşlenmişse sıfır olmayan; aksi takdirde 0.
Açıklamalar
Varsayılan uygulama hiçbir şey yapmaz. Ölçeklendirme denetimlerini etkinleştirmek için bu işlevi geçersiz kılmalısınız.
Not
Ortak OLE Nesne Özellikleri iletişim kutusu görüntülenmeden önce, çerçeve bu işlevi pItem için NULL ve nCurrentScale için - 1 ile çağırır. Bu, ölçeklendirme denetimlerinin etkinleştirilmesi gerekip gerekmediğini belirlemek için yapılır.
Ayrıca bkz.
MFC Örnek CIRC
COleDialog Sınıfı
Hiyerarşi Grafiği
COleDialog Sınıfı
CPropertyPage Sınıfı