COleInsertDialog Sınıfı
OLE Nesne Ekle iletişim kutusu için kullanılır.
Sözdizimi
class COleInsertDialog : public COleDialog
Üyeler
Ortak Oluşturucular
Ad | Tanım |
---|---|
COleInsertDialog::COleInsertDialog | Bir COleInsertDialog nesne oluşturur. |
Genel Yöntemler
Ad | Tanım |
---|---|
COleInsertDialog::CreateItem | İletişim kutusunda seçili öğeyi oluşturur. |
COleInsertDialog::D oModal | OLE Nesne Ekle iletişim kutusunu görüntüler. |
COleInsertDialog::GetClassID | Seçilen öğeyle ilişkili CLSID'yi alır. |
COleInsertDialog::GetDrawAspect | Öğenin simge olarak çizilip çizmeyeceğini bildirir. |
COleInsertDialog::GetIconicMetafile | Bu öğenin simgesel biçimiyle ilişkili meta dosyasının tanıtıcısını alır. |
COleInsertDialog::GetPathName | İletişim kutusunda seçilen dosyanın tam yolunu alır. |
COleInsertDialog::GetSelectionType | Seçilen nesnenin türünü alır. |
Ortak Veri Üyeleri
Ad | Tanım |
---|---|
COleInsertDialog::m_io | İletişim kutusunun davranışını denetleen OLEUIINSERTOBJECT türünde bir yapı. |
Açıklamalar
Bu iletişim kutusunu çağırmak istediğinizde sınıfın COleInsertDialog
nesnesini oluşturun. Bir COleInsertDialog
nesne oluşturulduktan sonra, iletişim kutusundaki denetimlerin değerlerini veya durumlarını başlatmak için m_io yapısını kullanabilirsiniz. Yapı m_io
OLEUIINSERTOBJECT türündedir. Bu iletişim kutusu sınıfını kullanma hakkında daha fazla bilgi için bkz . DoModal üye işlevi.
Dekont
Uygulama Sihirbazı tarafından oluşturulan kapsayıcı kodu bu sınıfı kullanır.
Daha fazla bilgi için Windows SDK'sında OLEUIINSERTOBJECT yapısına bakın.
OLE'ye özgü iletişim kutuları hakkında daha fazla bilgi için OLE'de İletişim Kutuları makalesine bakın.
Devralma Hiyerarşisi
COleInsertDialog
Gereksinimler
Üst bilgi: afxodlgs.h
COleInsertDialog::COleInsertDialog
Bu işlev yalnızca bir COleInsertDialog
nesne oluşturur.
COleInsertDialog (
DWORD dwFlags = IOF_SELECTCREATENEW,
CWnd* pParentWnd = NULL);
Parametreler
Dwflags
Bit düzeyinde OR işleci kullanılarak birleştirilecek aşağıdaki değerlerin herhangi bir sayısını içeren oluşturma bayrağı:
IOF_SHOWHELP İletişim kutusu çağrıldığında Yardım düğmesinin görüntüleneceğini belirtir.
IOF_SELECTCREATENEW İletişim kutusu çağrıldığında Başlangıçta Yeni Radyo Oluştur düğmesinin seçileceğini belirtir. Bu varsayılandır ve IOF_SELECTCREATEFROMFILE ile kullanılamaz.
IOF_SELECTCREATEFROMFILE İletişim kutusu çağrıldığında Başlangıçta Dosyadan Oluştur radyo düğmesinin seçileceğini belirtir. IOF_SELECTCREATENEW ile kullanılamaz.
IOF_CHECKLINK İletişim kutusu çağrıldığında Başlangıçta Bağlantı onay kutusunun işaretlendiğini belirtir.
IOF_DISABLELINK İletişim kutusu çağrıldığında Bağlantı onay kutusunun devre dışı bırakılacağını belirtir.
IOF_CHECKDISPLAYASICON Simge Olarak Görüntüle onay kutusunun başlangıçta işaretleneceğini, geçerli simgenin görüntüleneceğini ve iletişim kutusu çağrıldığında Simgeyi Değiştir düğmesinin etkinleştirileceğini belirtir.
IOF_VERIFYSERVERSEXIST İletişim kutusunun, kayıt veritabanında belirtilen sunucuların iletişim kutusu görüntülenmeden önce var olduğundan emin olarak liste kutusuna eklediği sınıfları doğrulaması gerektiğini belirtir. Bu bayrağın ayarlanması performansı önemli ölçüde etkileyebilir.
pParentWnd
İletişim kutusunun ait olduğu üst veya sahip pencere nesnesine (türünde CWnd
) işaret eder. NULL ise, iletişim kutusu nesnesinin üst penceresi ana uygulama penceresine ayarlanır.
Açıklamalar
İletişim kutusunu görüntülemek için DoModal işlevini çağırın.
COleInsertDialog::CreateItem
Yalnızca DoModal IDOK döndürürse COleClientItem türünde bir nesne oluşturmak için bu işlevi çağırın.
BOOL CreateItem(COleClientItem* pItem);
Parametreler
pItem
Oluşturulacak öğeyi gösterir.
İade Değeri
Öğe oluşturulduysa sıfır olmayan; aksi takdirde 0.
Açıklamalar
Bu işlevi çağırabilmeniz için önce nesnesini ayırmanız COleClientItem
gerekir.
COleInsertDialog::D oModal
OLE Nesne Ekle iletişim kutusunu görüntülemek için bu işlevi çağırın.
virtual INT_PTR
DoModal();
INT_PTR
DoModal(DWORD dwFlags);
Parametreler
Dwflags
Aşağıdaki değerlerden biri:
COleInsertDialog::DocObjectsOnly
yalnızca DocObjects ekler.
COleInsertDialog::ControlsOnly
yalnızca ActiveX denetimleri ekler.
Sıfır ne DocObject ne de ActiveX denetimi ekler. Bu değer, yukarıda listelenen ilk prototiple aynı uygulamayla sonuçlanmaktadır.
İade Değeri
İletişim kutusunun tamamlanma durumu. Aşağıdaki değerlerden biri:
İletişim kutusu başarıyla görüntüleniyorsa IDOK.
Kullanıcı iletişim kutusunu iptal ettiyse IDCANCEL.
Bir hata oluştuysa IDABORT. IDABORT döndürülürse, oluşan hata türü hakkında daha fazla bilgi edinmek için COleDialog::GetLastError üye işlevini çağırın. Olası hataların listesi için Windows SDK'sında OleUIInsertObject işlevine bakın.
Açıklamalar
m_io yapısının üyelerini ayarlayarak çeşitli iletişim kutusu denetimlerini başlatmak istiyorsanız, çağrısından önce DoModal
ancak iletişim kutusu nesnesi oluşturulduğunda bunu yapmalısınız.
IDOK döndürürse DoModal
, kullanıcı tarafından iletişim kutusuna ayarları veya bilgi girişini almak için diğer üye işlevlerini çağırabilirsiniz.
COleInsertDialog::GetClassID
Yalnızca DoModal IDOK döndürürse ve seçim türü ise COleInsertDialog::createNewItem
seçili öğeyle ilişkili CLSID'yi almak için bu işlevi çağırın.
REFCLSID GetClassID() const;
İade Değeri
Seçili öğeyle ilişkili CLSID'yi döndürür.
Açıklamalar
Daha fazla bilgi için bkz . Windows SDK'sında CLSID Anahtarı .
COleInsertDialog::GetDrawAspect
Kullanıcının seçili öğeyi simge olarak görüntülemeyi seçip seçmediğini belirlemek için bu işlevi çağırın.
DVASPECT GetDrawAspect() const;
İade Değeri
nesnesini işlemek için gereken yöntem.
DVASPECT_CONTENT Simge Olarak Görüntüle onay kutusu işaretlenmediyse döndürülür.
DVASPECT_ICON Simge Olarak Görüntüle onay kutusu işaretliyse döndürülür.
Açıklamalar
Bu işlevi yalnızca DoModal IDOK döndürürse çağır.
Çizim yönü hakkında daha fazla bilgi için bkz . Windows SDK'sında FORMATETC veri yapısı.
COleInsertDialog::GetIconicMetafile
Seçili öğenin simgesel yönünü içeren meta dosyasının tutamacını almak için bu işlevi çağırın.
HGLOBAL GetIconicMetafile() const;
İade Değeri
İletişim kutusu kapatıldığında Tamam; aksi takdirde NULL seçeneği belirlendiğinde Simge Olarak Görüntüle onay kutusu işaretlendiyse, seçili öğenin simgesel yönünü içeren meta dosyasının tutamacı.
COleInsertDialog::GetPathName
Yalnızca DoModal IDOK döndürürse ve seçim türü değilse COleInsertDialog::createNewItem
seçili dosyanın tam yolunu almak için bu işlevi çağırın.
CString GetPathName() const;
İade Değeri
İletişim kutusunda seçilen dosyanın tam yolu. Seçim türü ise createNewItem
, bu işlev yayın modunda anlamsız CString
bir değer döndürür veya hata ayıklama modunda onay işlemine neden olur.
COleInsertDialog::GetSelectionType
Tamam'ı seçerek Nesne Ekle iletişim kutusu kapatıldığında seçilen seçim türünü almak için bu işlevi çağırın.
UINT GetSelectionType() const;
İade Değeri
Yapılan seçimin türü.
Açıklamalar
Dönüş türü değerleri, sınıfında bildirilen COleInsertDialog
numaralandırma türü tarafından Selection
belirtilir.
enum Selection {
createNewItem,
insertFromFile,
linkToFile
};
Bu değerlerin kısa açıklamaları şunlardır:
COleInsertDialog::createNewItem
Yeni Radyo Oluştur düğmesi seçildi.COleInsertDialog::insertFromFile
Dosyadan Oluştur radyo düğmesi seçildi ve Bağlantı onay kutusu işaretlenmedi.COleInsertDialog::linkToFile
Dosyadan Oluştur radyo düğmesi seçildi ve Bağlantı onay kutusu işaretlendi.
COleInsertDialog::m_io
Nesne Ekle iletişim kutusunun davranışını denetlemek için kullanılan OLEUIINSERTOBJECT türünün yapısı.
OLEUIINSERTOBJECT m_io;
Açıklamalar
Bu yapının üyeleri doğrudan veya üye işlevleri aracılığıyla değiştirilebilir.
Daha fazla bilgi için Windows SDK'sında OLEUIINSERTOBJECT yapısına bakın.
Ayrıca bkz.
MFC Örnek OCLIENT
COleDialog Sınıfı
Hiyerarşi Grafiği
COleDialog Sınıfı
Geri Bildirim
https://aka.ms/ContentUserFeedback.
Çok yakında: 2024 boyunca, içerik için geri bildirim mekanizması olarak GitHub Sorunları’nı kullanımdan kaldıracak ve yeni bir geri bildirim sistemiyle değiştireceğiz. Daha fazla bilgi için bkz.Gönderin ve geri bildirimi görüntüleyin