COlePasteSpecialDialog Sınıfı

OLE Özel Yapıştır iletişim kutusu için kullanılır.

Sözdizimi

class COlePasteSpecialDialog : public COleDialog

Üyeler

Ortak Oluşturucular

Adı	Açıklama
COlePasteSpecialDialog::COlePasteSpecialDialog	Bir COlePasteSpecialDialog nesne oluşturur.

Genel Yöntemler

Adı	Açıklama
COlePasteSpecialDialog::AddFormat	Uygulamanızın yapıştırabileceği biçimler listesine özel biçimler ekler.
COlePasteSpecialDialog::AddLinkEntry	Desteklenen Pano biçimleri listesine yeni bir girdi ekler.
COlePasteSpecialDialog::AddStandardFormats	Uygulamanızın yapıştırabileceği biçimler listesine CF_BITMAP, CF_DIB, CF_METAFILEPICT ve isteğe bağlı olarak CF_LINKSOURCE ekler.
COlePasteSpecialDialog::CreateItem	Belirtilen biçimi kullanarak kapsayıcı belgesinde öğeyi oluşturur.
COlePasteSpecialDialog::D oModal	OLE Özel Yapıştır iletişim kutusunu görüntüler.
COlePasteSpecialDialog::GetDrawAspect	Öğenin simge olarak çizilip çizilmeyeceğini bildirir.
COlePasteSpecialDialog::GetIconicMetafile	Bu öğenin simgesel biçimiyle ilişkili meta dosyasının tanıtıcısını alır.
COlePasteSpecialDialog::GetPasteIndex	Kullanıcı tarafından seçilen kullanılabilir yapıştırma seçeneklerinin dizinini alır.
COlePasteSpecialDialog::GetSelectionType	Seçilen seçimin türünü alır.

Ortak Veri Üyeleri

Adı	Açıklama
COlePasteSpecialDialog::m_ps	İletişim kutusunun işlevini denetleen OLEUIPASTESPECIAL türünde bir yapı.

Açıklamalar

Bu iletişim kutusunu çağırmak istediğinizde sınıfın COlePasteSpecialDialog nesnesini oluşturun. Bir COlePasteSpecialDialog nesne oluşturulduktan sonra, iletişim kutusuna Pano biçimleri eklemek için AddFormat ve AddStandardFormats üye işlevlerini kullanabilirsiniz. İletişim kutusundaki denetimlerin değerlerini veya durumlarını başlatmak için m_ps yapısını da kullanabilirsiniz. Yapı m_ps OLEUIPASTESPECIAL türündedir.

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

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

COlePasteSpecialDialog

Gereksinimler

Üst bilgi: afxodlgs.h

COlePasteSpecialDialog::AddFormat

Özel Yapıştır işleminde uygulamanızın destekleyebileceğiniz biçimler listesine yeni biçimler eklemek için bu işlevi çağırın.

void AddFormat(
    const FORMATETC& formatEtc,
    LPTSTR lpszFormat,
    LPTSTR lpszResult,
    DWORD flags);

void AddFormat(
    UINT cf,
    DWORD tymed,
    UINT nFormatID,
    BOOL bEnableIcon,
    BOOL bLink);

Parametreler

Fmt
Eklenecek veri türüne başvuru.

lpszFormat
Kullanıcıya biçimi açıklayan dize.

lpszResult
İletişim kutusunda bu biçim seçilirse sonucu açıklayan dize.

Bayrak
Bu biçim için kullanılabilen farklı bağlama ve ekleme seçenekleri. Bu bayrak, OLEUIPASTEFLAG numaralandırılmış türündeki farklı değerlerden birinin veya daha fazlasının bit düzeyinde birleşimidir.

Cf
Eklenecek pano biçimi.

Tymed
Bu biçimde kullanılabilen medya türleri. Bu, TYMED numaralandırılmış türündeki bir veya daha fazla değerin bit düzeyinde birleşimidir.

nFormatID
Bu biçimi tanımlayan dizenin kimliği. Bu dizenin biçimi, '\n' karakteriyle ayrılmış iki ayrı dizedir. İlk dize lpstrFormat parametresinde geçirilecek dizeyle aynıdır ve ikincisi lpstrResult parametresiyle aynıdır.

bEnableIcon
Liste kutusunda bu biçim seçildiğinde Simge Olarak Görüntüle onay kutusunun etkinleştirilip etkinleştirilmediğini belirleyen bayrak.

Yanıp
Liste kutusunda bu biçim seçildiğinde Bağlantıyı Yapıştır radyo düğmesinin etkinleştirilip etkinleştirilmediğini belirleyen bayrak.

Açıklamalar

Bu işlev, uygulamanızın sisteme kaydettiği CF_TEXT veya CF_TIFF ya da özel biçimler gibi standart biçimler eklemek için çağrılabilir. Uygulamanıza veri nesneleri yapıştırma hakkında daha fazla bilgi için Veri Nesneleri ve Veri Kaynakları: Düzenleme makalesine bakın.

Daha fazla bilgi için bkz. Windows SDK'sında TYMED numaralandırma türü ve FORMATETC yapısı.

Daha fazla bilgi için bkz. Windows SDK'sında OLEUIPASTEFLAG numaralandırılmış türü.

COlePasteSpecialDialog::AddLinkEntry

Desteklenen Pano biçimleri listesine yeni bir girdi ekler.

OLEUIPASTEFLAG AddLinkEntry(UINT cf);

Parametreler

Cf
Eklenecek pano biçimi.

İade Değeri

Yeni bağlantı girdisinin bilgilerini içeren bir OLEUIPASTEFLAG yapısı.

COlePasteSpecialDialog::AddStandardFormats

Özel Yapıştır işleminde uygulamanızın destekleyebileceğiniz biçimler listesine aşağıdaki Pano biçimlerini eklemek için bu işlevi çağırın:

void AddStandardFormats(BOOL bEnableLink = TRUE);

Parametreler

bEnableLink
Uygulamanızın yapıştırabileceği biçimler listesine CF_LINKSOURCE eklenip eklenmeyeceğini belirleyen bayrak.

Açıklamalar

• CF_BITMAP

• CF_DIB

• CF_METAFILEPICT

• "Katıştırılmış Nesne"

• (isteğe bağlı olarak) " Bağlantı Kaynağı"

Bu biçimler ekleme ve bağlamayı desteklemek için kullanılır.

COlePasteSpecialDialog::COlePasteSpecialDialog

Bir COlePasteSpecialDialog nesne oluşturur.

COlePasteSpecialDialog(
    DWORD dwFlags = PSF_SELECTPASTE,
    COleDataObject* pDataObject = NULL,
    CWnd* pParentWnd = NULL);

Parametreler

Dwflags
Oluşturma bayrağı, bit düzeyinde OR işleci kullanılarak birleştirilen aşağıdaki bayrakların herhangi bir sayısını içerir:

• PSF_SELECTPASTE İletişim kutusu çağrıldığında Radyo yapıştır düğmesinin başlangıçta denetleneceğini belirtir. PSF_SELECTPASTELINK ile birlikte kullanılamaz. Bu varsayılan seçenektir.

• PSF_SELECTPASTELINK İletişim kutusu çağrıldığında Bağlantıyı Yapıştır radyo düğmesinin başlangıçta denetleneceğini belirtir. PSF_SELECTPASTE ile birlikte kullanılamaz.

• PSF_CHECKDISPLAYASICON İletişim kutusu çağrıldığında başlangıçta Simge Olarak Görüntüle onay kutusunun işaretleneceğini belirtir.

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

pDataObject
Yapıştırma için COleDataObject öğesine işaret eder. Bu değer NULL ise Pano'dan değerini alır COleDataObject .

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

Bu işlev yalnızca bir COlePasteSpecialDialog nesne oluşturur. İletişim kutusunu görüntülemek için DoModal işlevini çağırın.

Daha fazla bilgi için bkz. Windows SDK'sında OLEUIPASTEFLAG numaralandırılmış türü.

COlePasteSpecialDialog::CreateItem

Özel Yapıştır iletişim kutusunda seçilen yeni öğeyi oluşturur.

BOOL CreateItem(COleClientItem* pNewItem);

Parametreler

pNewItem
Bir örneğe işaret eden.COleClientItem NULL olamaz.

İade Değeri

Öğe başarıyla oluşturulduysa sıfır olmayan; aksi takdirde 0.

Açıklamalar

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

COlePasteSpecialDialog::D oModal

OLE Özel Yapıştır iletişim kutusunu görüntüler.

virtual INT_PTR DoModal();

İ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 üye işlevini çağırın COleDialog::GetLastError . Olası hataların listesi için Windows SDK'sında OleUIPasteSpecial işlevine bakın.

Açıklamalar

m_ps 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.

COlePasteSpecialDialog::GetDrawAspect

Kullanıcının seçili öğeyi simge olarak görüntülemeyi seçip seçmediğini belirler.

DVASPECT GetDrawAspect() const;

İade Değeri

nesnesini işlemek için gereken yöntem.

• DVASPECT_CONTENT İletişim kutusu kapatıldığında Simge Olarak Görüntüle onay kutusu işaretlenmediyse döndürülür.

• DVASPECT_ICON İletişim kutusu kapatıldığında 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 yapısına bakın.

COlePasteSpecialDialog::GetIconicMetafile

Kullanıcı tarafından seçilen öğeyle ilişkili meta dosyasını alır.

HGLOBAL GetIconicMetafile() const;

İade Değeri

İletişim kutusu kapatıldığında Simge Olarak Görüntüle onay kutusu seçiliyse, Tamam; aksi takdirde NULL seçeneğini belirleyerek seçili öğenin simgesel yönünü içeren meta dosyasının tutamacı.

COlePasteSpecialDialog::GetPasteIndex

Kullanıcının seçtiği girişle ilişkili dizin değerini alır.

int GetPasteIndex() const;

İade Değeri

Kullanıcı tarafından seçilen yapı dizisinin OLEUIPASTEENTRY dizini. Yapıştırma işlemi gerçekleştirilirken seçili dizine karşılık gelen biçim kullanılmalıdır.

Açıklamalar

Daha fazla bilgi için windows SDK'sında OLEUIPASTEENTRY yapısına bakın.

COlePasteSpecialDialog::GetSelectionType

Kullanıcının yaptığı seçim türünü belirler.

UINT GetSelectionType() const;

İade Değeri

Yapılan seçimin türünü döndürür.

Açıklamalar

Dönüş türü değerleri, sınıfında bildirilen COlePasteSpecialDialog numaralandırma türü tarafından Selection belirtilir.

enum Selection {
    pasteLink,
    pasteNormal,
    pasteOther,
    pasteStatic
    };

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

• COlePasteSpecialDialog::pasteLink Bağlantıyı Yapıştır radyo düğmesi denetlendi ve seçilen biçim standart bir OLE biçimiydi.

• COlePasteSpecialDialog::pasteNormal Radyo yapıştır düğmesi işaretlendi ve seçilen biçim standart bir OLE biçimiydi.

• COlePasteSpecialDialog::pasteOther Seçilen biçim standart bir OLE biçimi değil.

• COlePasteSpecialDialog::pasteStatic Seçilen biçim bir meta dosyasıydı.

COlePasteSpecialDialog::m_ps

Özel Yapıştır iletişim kutusunun davranışını denetlemek için kullanılan OLEUIPASTESPECIAL türünün yapısı.

OLEUIPASTESPECIAL m_ps;

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 OLEUIPASTESPECIAL yapısı.

Ayrıca bkz.

MFC Örnek OCLIENT
COleDialog Sınıfı
Hiyerarşi Grafiği
COleDialog Sınıfı