Sdílet prostřednictvím

COlePasteSpecialDialog – třída

  • Článek

Používá se pro dialogové okno Ole Vložit jinak.

Syntaxe

class COlePasteSpecialDialog : public COleDialog

Členové

Veřejné konstruktory

Název Popis
COlePasteSpecialDialog::COlePasteSpecialDialog COlePasteSpecialDialog Vytvoří objekt.

Veřejné metody

Název Popis
COlePasteSpecialDialog::AddFormat Přidá vlastní formáty do seznamu formátů, které může vaše aplikace vložit.
COlePasteSpecialDialog::AddLinkEntry Přidá novou položku do seznamu podporovaných formátů schránky.
COlePasteSpecialDialog::AddStandardFormats Přidá CF_BITMAP, CF_DIB, CF_METAFILEPICT a volitelně CF_LINKSOURCE do seznamu formátů, které může aplikace vložit.
COlePasteSpecialDialog::CreateItem Vytvoří položku v dokumentu kontejneru pomocí zadaného formátu.
COlePasteSpecialDialog::D oModal Zobrazí dialogové okno Ole Vložit jinak.
COlePasteSpecialDialog::GetDrawAspect Určuje, jestli se má položka kreslit jako ikona, nebo ne.
COlePasteSpecialDialog::GetIconicMetafile Získá popisovač metasouboru asociované s ikonickou formou této položky.
COlePasteSpecialDialog::GetPasteIndex Získá index dostupných možností vložení, které uživatel zvolil.
COlePasteSpecialDialog::GetSelectionType Získá vybraný typ výběru.

Veřejné datové členy

Název Popis
COlePasteSpecialDialog::m_ps Struktura typu OLEUIPASTESPECIAL, která řídí funkci dialogového okna.

Poznámky

Pokud chcete volat toto dialogové okno, vytvořte objekt třídy COlePasteSpecialDialog . Po vytvoření objektu COlePasteSpecialDialog můžete k přidání formátů schránky do dialogového okna použít členské funkce AddFormat a AddStandardFormats . Pomocí struktury m_ps můžete také inicializovat hodnoty nebo stavy ovládacích prvků v dialogovém okně. Struktura m_ps je typu OLEUIPASTESPECIAL.

Další informace naleznete v OLEUIPASTESPECIAL struktury v sadě Windows SDK.

Další informace o dialogových oknech specifických pro OLE naleznete v článku Dialogová okna v OLE.

Hierarchie dědičnosti

Objekt CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COlePasteSpecialDialog

Požadavky

Hlavička: afxodlgs.h

COlePasteSpecialDialog::AddFormat

Voláním této funkce přidáte nové formáty do seznamu formátů, které může vaše aplikace podporovat v operaci Vložit jinak.

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

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

Parametry

Fmt
Odkaz na datový typ, který chcete přidat.

lpszFormat
Řetězec, který popisuje formát pro uživatele.

lpszResult
Řetězec, který popisuje výsledek, pokud je tento formát vybrán v dialogovém okně.

vlajky
Pro tento formát jsou k dispozici různé možnosti propojení a vkládání. Tento příznak je bitové kombinace jedné nebo více různých hodnot v výčtu OLEUIPASTEFLAG.

viz
Formát schránky, který chcete přidat.

tymed
Typy médií dostupné v tomto formátu. Jedná se o bitovou kombinaci jedné nebo více hodnot v výčtovém typu TYMED.

nFormatID
ID řetězce, který identifikuje tento formát. Formát tohoto řetězce je dva samostatné řetězce oddělené znakem \n. První řetězec je stejný, který by byl předán v lpstrFormat parametru a druhý je stejný jako lpstrResult parametr.

bEnableIcon
Příznak určující, zda je zaškrtávací políčko Zobrazit jako ikonu povoleno, pokud je tento formát vybrán v seznamu.

blikat
Příznak určující, zda je přepínač Vložit odkaz povolen, pokud je tento formát vybrán v seznamu.

Poznámky

Tuto funkci lze volat, pokud chcete přidat standardní formáty, jako jsou CF_TEXT nebo CF_TIFF nebo vlastní formáty, které aplikace zaregistrovala v systému. Další informace o vkládání datových objektů do aplikace najdete v článku Datové objekty a zdroje dat: Manipulace.

Další informace naleznete v souboru TYMED – typ výčtu a struktura FORMATETC v sadě Windows SDK.

Další informace naleznete v oleUIPASTEFLAG výčtu typu v sadě Windows SDK.

COlePasteSpecialDialog::AddLinkEntry

Přidá novou položku do seznamu podporovaných formátů schránky.

OLEUIPASTEFLAG AddLinkEntry(UINT cf);

Parametry

viz
Formát schránky, který chcete přidat.

Návratová hodnota

OleUIPASTEFLAG struktura obsahující informace pro novou položku propojení.

COlePasteSpecialDialog::AddStandardFormats

Voláním této funkce přidejte následující formáty schránky do seznamu formátů, které může vaše aplikace podporovat v operaci Vložit jinak:

void AddStandardFormats(BOOL bEnableLink = TRUE);

Parametry

bEnableLink
Příznak, který určuje, zda chcete přidat CF_LINKSOURCE do seznamu formátů, které může aplikace vložit.

Poznámky

  • CF_BITMAP

  • CF_DIB

  • CF_METAFILEPICT

  • "Vložený objekt"

  • (volitelně) " Zdroj propojení"

Tyto formáty se používají k podpoře vkládání a propojení.

COlePasteSpecialDialog::COlePasteSpecialDialog

COlePasteSpecialDialog Vytvoří objekt.

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

Parametry

dwFlags
Příznak vytvoření obsahuje libovolný počet následujících příznaků zkombinovaných pomocí bitového operátoru OR:

  • PSF_SELECTPASTE Určuje, že při zavolání dialogového okna se na začátku zaškrtne přepínač Vložit. Nelze použít v kombinaci s PSF_SELECTPASTELINK. Tato možnost je výchozí.

  • PSF_SELECTPASTELINK Určuje, že se při zavolání dialogového okna zaškrtne přepínač Vložit propojení. Nelze použít v kombinaci s PSF_SELECTPASTE.

  • PSF_CHECKDISPLAYASICON Určuje, že se při zavolání dialogového okna zaškrtne políčko Zobrazit jako ikonu.

  • PSF_SHOWHELP Určuje, že se při zavolání dialogového okna zobrazí tlačítko Nápověda.

pDataObject
Odkazuje na objekt COleDataObject pro vložení. Pokud je tato hodnota NULL, získá COleDataObject z schránky.

pParentWnd
Odkazuje na objekt okna nadřazeného nebo vlastníka (typu CWnd), do kterého objekt dialogového okna patří. Pokud je null, nadřazené okno dialogového okna je nastaveno na hlavní okno aplikace.

Poznámky

Tato funkce vytváří COlePasteSpecialDialog pouze objekt. Dialogové okno zobrazíte voláním funkce DoModal .

Další informace naleznete v oleUIPASTEFLAG výčtu typu v sadě Windows SDK.

COlePasteSpecialDialog::CreateItem

Vytvoří novou položku vybranou v dialogovém okně Vložit jinak.

BOOL CreateItem(COleClientItem* pNewItem);

Parametry

pNewItem
Odkazuje na COleClientItem instanci. Nesmí mít hodnotu NULL.

Návratová hodnota

Nenulové, pokud byla položka úspěšně vytvořena; jinak 0.

Poznámky

Tato funkce by měla být volána pouze poté, co DoModal vrátí IDOK.

COlePasteSpecialDialog::D oModal

Zobrazí dialogové okno Ole Vložit jinak.

virtual INT_PTR DoModal();

Návratová hodnota

Stav dokončení dialogového okna Jedna z následujících hodnot:

  • IdOK, pokud se dialogové okno úspěšně zobrazilo.

  • IDCANCEL pokud uživatel zrušil dialogové okno.

  • IDABORT, pokud došlo k chybě. Pokud se vrátí funkce IDABORT, zavolejte COleDialog::GetLastError členovu funkci a získejte další informace o typu chyby, ke které došlo. Seznam možných chyb naleznete v oleUIPasteSpecial funkce v sadě Windows SDK.

Poznámky

Pokud chcete inicializovat různé ovládací prvky dialogového okna nastavením členů struktury m_ps , měli byste to udělat před voláním DoModal, ale po vytvoření objektu dialogového okna.

Pokud DoModal vrátí idOK, můžete volat další členské funkce, které načtou nastavení nebo informace zadané uživatelem do dialogového okna.

COlePasteSpecialDialog::GetDrawAspect

Určuje, jestli se uživatel rozhodl zobrazit vybranou položku jako ikonu.

DVASPECT GetDrawAspect() const;

Návratová hodnota

Metoda potřebná k vykreslení objektu.

  • DVASPECT_CONTENT Vráceno, pokud se při zavření dialogového okna nezaškrtlo políčko Zobrazit jako ikonu.

  • DVASPECT_ICON Vráceno, pokud bylo při zavření dialogového okna zaškrtnuto políčko Zobrazit jako ikonu.

Poznámky

Volání této funkce pouze po doModal vrátí IDOK.

Další informace o aspektu výkresu naleznete ve struktuře FORMATETC v sadě Windows SDK.

COlePasteSpecialDialog::GetIconicMetafile

Získá metasoubor přidružený k položce vybrané uživatelem.

HGLOBAL GetIconicMetafile() const;

Návratová hodnota

Popisovač metasouboru obsahující ikonický aspekt vybrané položky, pokud bylo při zavření dialogového okna zaškrtnuté políčko Zobrazit jako ikonu; jinak NULL.

COlePasteSpecialDialog::GetPasteIndex

Získá hodnotu indexu přidruženou k položce, kterou uživatel vybral.

int GetPasteIndex() const;

Návratová hodnota

Index do pole struktur vybraných OLEUIPASTEENTRY uživatelem. Formát odpovídající vybranému indexu by se měl použít při provádění operace vložení.

Poznámky

Další informace naleznete v OLEUIPASTEENTRY struktury v sadě Windows SDK.

COlePasteSpecialDialog::GetSelectionType

Určuje typ výběru, který uživatel provedl.

UINT GetSelectionType() const;

Návratová hodnota

Vrátí typ výběru.

Poznámky

Hodnoty návratového typu jsou určeny typem výčtu Selection deklarovaným ve COlePasteSpecialDialog třídě.

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

Stručný popis těchto hodnot:

  • COlePasteSpecialDialog::pasteLink Přepínač Vložit propojení byl zaškrtnutý a zvolený formát byl standardním formátem OLE.

  • COlePasteSpecialDialog::pasteNormal Přepínač Vložit byl zaškrtnut a zvolený formát byl standardním formátem OLE.

  • COlePasteSpecialDialog::pasteOther Vybraný formát není standardním formátem OLE.

  • COlePasteSpecialDialog::pasteStatic Zvolený formát byl metasoubor.

COlePasteSpecialDialog::m_ps

Struktura typu OLEUIPASTESPECIAL slouží k řízení chování dialogového okna Vložit jinak.

OLEUIPASTESPECIAL m_ps;

Poznámky

Členy této struktury lze upravovat přímo nebo prostřednictvím členských funkcí.

Další informace naleznete v OLEUIPASTESPECIAL struktury v sadě Windows SDK.

Viz také

MFC – ukázka OCLIENT
COleDialog – třída
Graf hierarchie
COleDialog – třída