COleConvertDialog osztály

Megjegyzés:

A Microsoft Foundation Classes (MFC) könyvtár továbbra is támogatott. A továbbiakban azonban nem adunk hozzá funkciókat, és nem frissítjük a dokumentációt.

További információ: OLEUICONVERT struktúra a Windows SDK-ban.

Szemantika

class COleConvertDialog : public COleDialog

Tagok

Nyilvános konstruktorok

Név Description
COleConvertDialog::COleConvertDialog Egy COleConvertDialog objektumot hoz létre.

Nyilvános metódusok

Név Description
COleConvertDialog::D oConvert Végrehajtja a párbeszédpanelen megadott átalakítást.
COleConvertDialog::D oModal Megjeleníti az OLE Elem módosítása párbeszédpanelt.
COleConvertDialog::GetClassID Lekéri a kiválasztott elemhez társított CLSID azonosítót.
COleConvertDialog::GetDrawAspect Megadja, hogy az elemet ikonként kell-e rajzolni.
COleConvertDialog::GetIconicMetafile Lekéri az elem ikonikus formájához társított metafájl leíróját.
COleConvertDialog::GetSelectionType Lekéri a kiválasztott kijelölés típusát.

Nyilvános adatok tagjai

Név Description
COleConvertDialog::m_cv A párbeszédpanel viselkedését vezérlő struktúra.

Megjegyzések

Megjegyzés:

Az alkalmazásvarázsló által létrehozott tárolókód ezt az osztályt használja.

Az OLE-specifikus párbeszédpanelekről további információt az OLE párbeszédpanelek című cikkben talál.

Öröklési hierarchia

CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleConvertDialog

Requirements

Fejléc: afxodlgs.h

COleConvertDialog::COleConvertDialog

Csak egy objektumot COleConvertDialog hoz létre.

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

Paraméterek

pItem
A konvertálni vagy aktiválni kívánt elemre mutat.

dwFlags
Létrehozási jelző, amely az alábbi értékek tetszőleges számát tartalmazza a bitenkénti vagy operátorral kombinálva:

  • CF_SELECTCONVERTTO Megadja, hogy a párbeszédpanel meghívásakor először a Konvertálás választógomb legyen kiválasztva. Ez az alapértelmezett beállítás.

  • CF_SELECTACTIVATEAS Megadja, hogy a párbeszédpanel meghívásakor először az Aktiválás választógomb legyen kiválasztva.

  • CF_SETCONVERTDEFAULT Azt adja meg, hogy az osztály, amelynek CLSID-jét a clsidConvertDefaultm_cv struktúra tagja adja meg, az osztálylista alapértelmezett kijelöléseként használja a rendszer, amikor a Konvertálás választógombot választja.

  • CF_SETACTIVATEDEFAULT Megadja, hogy a struktúra tagja m_cv által clsidActivateDefault megadott CLSID-azonosítót tartalmazó osztály legyen az alapértelmezett kijelölés az osztálylistában az Aktiválás választógomb kiválasztásakor.

  • CF_SHOWHELPBUTTON Megadja, hogy a párbeszédpanel meghívásakor a Súgó gomb jelenik meg.

pClassID
A konvertálni vagy aktiválni kívánt elem CLSID azonosítójára mutat. Null érték esetén a rendszer a pItemhez társított CLSID azonosítót használja.

pParentWnd
Arra a szülő- vagy tulajdonosablak-objektumra mutat (típus CWnd), amelyhez a párbeszédpanel-objektum tartozik. Null érték esetén a párbeszédpanel szülőablaka a fő alkalmazásablakra van állítva.

Megjegyzések

A párbeszédpanel megjelenítéséhez hívja meg a DoModal függvényt.

További információkért lásd a CLSID-kulcsot és az OLEUICONVERT struktúrát .

COleConvertDialog::D oConvert

Hívja meg ezt a függvényt, miután sikeresen visszatért a DoModalból egy COleClientItem típusú objektum konvertálásához vagy aktiválásához.

BOOL DoConvert(COleClientItem* pItem);

Paraméterek

pItem
A konvertálni vagy aktiválni kívánt elemre mutat. Nem lehet NULL.

Visszaadott érték

Nonzero, ha sikeres; egyéb esetben 0.

Megjegyzések

Az elem konvertálása vagy aktiválása a felhasználó által a Konvertálás párbeszédpanelen kiválasztott információknak megfelelően történik.

COleConvertDialog::D oModal

Hívja meg ezt a függvényt az OLE Konvertálás párbeszédpanel megjelenítéséhez.

virtual INT_PTR DoModal();

Visszaadott érték

A párbeszédpanel befejezési állapota. Az alábbi értékek egyike:

  • IDOK, ha a párbeszédpanel sikeresen megjelent.

  • IDCANCEL, ha a felhasználó megszakította a párbeszédpanelt.

  • IDABORT, ha hiba történt. Ha IDABORT-t ad vissza, hívja meg a COleDialog::GetLastError tagfüggvényt, hogy további információt kapjon a hiba típusáról. A lehetséges hibák listáját a Windows SDK OleUIConvert függvényében talál.

Megjegyzések

Ha a m_cv szerkezet tagjainak beállításával szeretné inicializálni a különböző párbeszédpanel-vezérlőket, ezt a hívás DoModalelőtt, de a párbeszédpanel-objektum létrehozása után kell elvégeznie.

Ha DoModal IDOK-t ad vissza, meghívhat más tagfüggvényeket, hogy lekérje a felhasználó által bevitt beállításokat vagy információkat a párbeszédpanelen.

COleConvertDialog::GetClassID

Hívja meg ezt a függvényt, hogy lekérje a konvertálás párbeszédpanelen kiválasztott felhasználóhoz társított CLSID azonosítót.

REFCLSID GetClassID() const;

Visszaadott érték

A Konvertálás párbeszédpanelen kijelölt elemhez társított CLSID.

Megjegyzések

Ezt a függvényt csak akkor hívja meg, ha a DoModal visszaadja az IDOK-ot.

További információ: CLSID-kulcs a Windows SDK-ban.

COleConvertDialog::GetDrawAspect

Hívja meg ezt a függvényt annak megállapításához, hogy a felhasználó a kijelölt elem ikonként való megjelenítését választotta-e.

DVASPECT GetDrawAspect() const;

Visszaadott érték

Az objektum megjelenítéséhez szükséges metódus.

  • DVASPECT_CONTENT Vissza, ha a Megjelenítés ikonként jelölőnégyzet nincs bejelölve.

  • DVASPECT_ICON Vissza lett adva, ha a Megjelenítés ikonként jelölőnégyzet be van jelölve.

Megjegyzések

Ezt a függvényt csak akkor hívja meg, ha a DoModal visszaadja az IDOK-ot.

A rajz aspektusával kapcsolatos további információkért tekintse meg a FORMATETC adatstruktúráját a Windows SDK-ban.

COleConvertDialog::GetIconicMetafile

Hívja meg ezt a függvényt, hogy lekérje a kijelölt elem ikonikus elemét tartalmazó metafájl leíróját.

HGLOBAL GetIconicMetafile() const;

Visszaadott érték

A kijelölt elem ikonikus elemét tartalmazó metafájlhoz tartozó fogópont, ha a párbeszédpanel bezárásakor a Megjelenítés ikonként jelölőnégyzet be van jelölve az OK gombra kattintva; ellenkező esetben NULL.

COleConvertDialog::GetSelectionType

Hívja meg ezt a függvényt a Konvertálás párbeszédpanelen kiválasztott átalakítás típusának meghatározásához.

UINT GetSelectionType() const;

Visszaadott érték

A kiválasztott elem típusa.

Megjegyzések

A visszatérési típus értékeit az Selection osztályban deklarált enumerálási COleConvertDialog típus adja meg.

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Az értékek rövid leírása a következő:

  • COleConvertDialog::noConversion Vissza lett adva, ha a párbeszédpanel megszakadt, vagy a felhasználó nem jelölt ki átalakítást. Ha COleConvertDialog::DoModal idOK-t ad vissza, lehetséges, hogy a felhasználó a korábban kijelölt ikontól eltérő ikont választott.

  • COleConvertDialog::convertItem Ha a Konvertálás választógomb be van jelölve, a felhasználó kiválasztott egy másik elemet, amelybe konvertálni szeretné, és DoModal visszaadta az IDOK-ot.

  • COleConvertDialog::activateAs Az Aktiválás választógomb bejelölése esetén a felhasználó kiválasztott egy másik aktiválandó elemet, és DoModal visszaadta az IDOK azonosítót.

COleConvertDialog::m_cv

Az OLEUICONVERT típusú struktúra, amely a Konvertálás párbeszédpanel viselkedésének szabályozására szolgál.

OLEUICONVERT m_cv;

Megjegyzések

A struktúra tagjai közvetlenül vagy tagfüggvényekkel módosíthatók.

További információ: OLEUICONVERT struktúra a Windows SDK-ban.

Lásd még

COleDialog osztály
hierarchiadiagram
COleDialog osztály

  • Last updated on