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

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

Genel Yöntemler

Veri Akışı Adı	Açıklama
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

Veri Akışı Adı	Açıklama
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.

Not

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

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

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.

Dönüş 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.

Dönüş 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 DoModalancak 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::createNewItemseçili öğeyle ilişkili CLSID'yi almak için bu işlevi çağırın.

REFCLSID GetClassID() const;

Dönüş 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;

Dönüş 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;

Dönüş 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::createNewItemseçili dosyanın tam yolunu almak için bu işlevi çağırın.

CString GetPathName() const;

Dönüş 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;

Dönüş 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ı