COleConvertDialog Sınıfı

Daha fazla bilgi için bkz . Windows SDK'sında OLEUICONVERT yapısı.

Sözdizimi

class COleConvertDialog : public COleDialog

Üyeler

Ortak Oluşturucular

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

Genel Yöntemler

Veri Akışı Adı	Açıklama
COleConvertDialog::D oConvert	İletişim kutusunda belirtilen dönüştürmeyi gerçekleştirir.
COleConvertDialog::D oModal	OLE Öğe Değiştir iletişim kutusunu görüntüler.
COleConvertDialog::GetClassID	Seçilen öğeyle ilişkili CLSID'yi alır.
COleConvertDialog::GetDrawAspect	Öğenin simge olarak çizilip çizmeyeceğini belirtir.
COleConvertDialog::GetIconicMetafile	Bu öğenin simgesel biçimiyle ilişkili meta dosyasının tanıtıcısını alır.
COleConvertDialog::GetSelectionType	Seçilen seçimin türünü alır.

Ortak Veri Üyeleri

Veri Akışı Adı	Açıklama
COleConvertDialog::m_cv	İletişim kutusunun davranışını denetleen bir yapı.

Açıklamalar

Not

Uygulama Sihirbazı tarafından oluşturulan kapsayıcı kodu bu sınıfı kullanır.

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

COleConvertDialog

Gereksinimler

Üst bilgi: afxodlgs.h

COleConvertDialog::COleConvertDialog

Yalnızca bir COleConvertDialog nesne oluşturur.

explicit COleConvertDialog (
    COleClientItem* pItem,
    DWORD dwFlags = CF_SELECTCONVERTTO,
    CLSID* pClassID = NULL,
    CWnd* pParentWnd = NULL);

Parametreler

pItem
Dönüştürülecek veya etkinleştirilecek öğeyi gösterir.

dwFlags
Bit düzeyinde veya işleci kullanılarak birleştirilen aşağıdaki değerlerden herhangi birini içeren oluşturma bayrağı:

• CF_SELECTCONVERTTO İletişim kutusu çağrıldığında başlangıçta Dönüştür radyo düğmesinin seçileceğini belirtir. Bu varsayılan seçenektir.

• CF_SELECTACTIVATEAS İletişim kutusu çağrıldığında başlangıçta Farklı Etkinleştir radyo düğmesinin seçileceğini belirtir.

• CF_SETCONVERTDEFAULT CLSID'sinin yapı üyesi tarafından clsidConvertDefault belirtildiği sınıfın m_cv , Dönüştür radyo düğmesi seçildiğinde sınıf liste kutusunda varsayılan seçim olarak kullanılacağını belirtir.

• CF_SETACTIVATEDEFAULT CLSID'sinin yapı üyesi tarafından clsidActivateDefault belirtildiği sınıfın m_cv , Farklı Etkinleştir radyo düğmesi seçildiğinde sınıf liste kutusunda varsayılan seçim olarak kullanılacağını belirtir.

• CF_SHOWHELPBUTTON İletişim kutusu çağrıldığında Yardım düğmesinin görüntüleneceğini belirtir.

pClassID
Dönüştürülecek veya etkinleştirilecek öğenin CLSID'sini gösterir. NULL ise, pItem ile ilişkili CLSID kullanılır.

pParentWnd
İletişim kutusunun ait olduğu üst veya sahip pencere nesnesine (türünde CWnd) işaret eder. NULL ise, iletişim kutusunun üst penceresi ana uygulama penceresine ayarlanır.

Açıklamalar

İletişim kutusunu görüntülemek için DoModal işlevini çağırın.

Daha fazla bilgi için bkz . CLSID Anahtarı ve OLEUICONVERT yapısı.

COleConvertDialog::D oConvert

COleClientItem türünde bir nesneyi dönüştürmek veya etkinleştirmek için DoModal'dan başarıyla döndürdükten sonra bu işlevi çağırın.

BOOL DoConvert(COleClientItem* pItem);

Parametreler

pItem
Dönüştürülecek veya etkinleştirilecek öğeyi gösterir. NULL olamaz.

Dönüş Değeri

Başarılı olursa sıfır olmayan; aksi takdirde 0.

Açıklamalar

Öğe, dönüştür iletişim kutusunda kullanıcı tarafından seçilen bilgilere göre dönüştürülür veya etkinleştirilir.

COleConvertDialog::D oModal

OLE Dönüştürme iletişim kutusunu görüntülemek için bu işlevi çağırın.

virtual INT_PTR DoModal();

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 OleUIConvert işlevine bakın.

Açıklamalar

m_cv 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 , iletişim kutusuna kullanıcı tarafından giriş yapılan ayarları veya bilgileri almak için diğer üye işlevlerini çağırabilirsiniz.

COleConvertDialog::GetClassID

Kullanıcının Dönüştür iletişim kutusunda seçtiği öğeyle ilişkili CLSID'yi almak için bu işlevi çağırın.

REFCLSID GetClassID() const;

Dönüş Değeri

Dönüştür iletişim kutusunda seçilen öğeyle ilişkili CLSID.

Açıklamalar

Bu işlevi yalnızca DoModal IDOK döndürdüğünde çağır.

Daha fazla bilgi için bkz . Windows SDK'sında CLSID Anahtarı .

COleConvertDialog::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ürdüğünde çağır.

Çizim yönü hakkında daha fazla bilgi için Windows SDK'sında FORMATETC veri yapısına bakın.

COleConvertDialog::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'ı seçerek Simge Olarak Görüntüle onay kutusu işaretlendiyse, seçili öğenin simgesel yönünü içeren meta dosyasının tutamacı; aksi takdirde NULL.

COleConvertDialog::GetSelectionType

Dönüştür iletişim kutusunda seçilen dönüştürme türünü belirlemek 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 COleConvertDialog numaralandırma türü tarafından Selection belirtilir.

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Bu değerlerin kısa açıklamaları şunlardır:

• COleConvertDialog::noConversion İletişim kutusu iptal edildiyse veya kullanıcı dönüştürmeyi seçmediyse döndürülür. IDOK döndürülürse COleConvertDialog::DoModal , kullanıcının daha önce seçilenden farklı bir simge seçmesi mümkündür.

• COleConvertDialog::convertItem Dönüştür radyo düğmesi işaretliyse, kullanıcı dönüştürülecek farklı bir öğe seçti ve DoModal IDOK döndürdü.

• COleConvertDialog::activateAs Farklı Etkinleştir radyo düğmesi işaretliyse, kullanıcı etkinleştirmek için farklı bir öğe seçti ve DoModal IDOK döndürdü.

COleConvertDialog::m_cv

Dönüştür iletişim kutusunun davranışını denetlemek için kullanılan OLEUICONVERT türünün yapısı.

OLEUICONVERT m_cv;

Açıklamalar

Bu yapının üyeleri doğrudan veya üye işlevleri aracılığıyla değiştirilebilir.

Daha fazla bilgi için bkz . Windows SDK'sında OLEUICONVERT yapısı.

Ayrıca bkz.

COleDialog Sınıfı
Hiyerarşi Grafiği
COleDialog Sınıfı