Klasa COleConvertDialog

Aby uzyskać więcej informacji, zobacz strukturę OLEUICONVERT w zestawie WINDOWS SDK.

Składnia

class COleConvertDialog : public COleDialog

Członkowie

Konstruktory publiczne

Nazwa/nazwisko	opis
COleConvertDialog::COleConvertDialog	COleConvertDialog Tworzy obiekt.

Metody publiczne

Nazwa/nazwisko	opis
COleConvertDialog::D oConvert	Wykonuje konwersję określoną w oknie dialogowym.
COleConvertDialog::D oModal	Wyświetla okno dialogowe Zmienianie elementu OLE.
COleConvertDialog::GetClassID	Pobiera identyfikator CLSID skojarzony z wybranym elementem.
COleConvertDialog::GetDrawAspect	Określa, czy element ma być rysowy jako ikona.
COleConvertDialog::GetIconicMetafile	Pobiera uchwyt do metapliku skojarzonego z kultową formą tego elementu.
COleConvertDialog::GetSelectionType	Pobiera wybrany typ zaznaczenia.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
COleConvertDialog::m_cv	Struktura, która kontroluje zachowanie okna dialogowego.

Uwagi

Uwaga

Kod kontenera wygenerowany przez Kreatora aplikacji używa tej klasy.

Aby uzyskać więcej informacji na temat okien dialogowych specyficznych dla ole, zobacz artykuł Okna dialogowe w ole.

Hierarchia dziedziczenia

Cobject

Ccmdtarget

Cwnd

Cdialog

CCommonDialog

COleDialog

COleConvertDialog

Wymagania

Nagłówek: afxodlgs.h

COleConvertDialog::COleConvertDialog

Tworzy tylko COleConvertDialog obiekt.

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

Parametry

pItem
Wskazuje element, który ma zostać przekonwertowany lub aktywowany.

Dwflags
Flaga tworzenia zawierająca dowolną liczbę następujących wartości połączonych przy użyciu operatora bitowego lub:

• CF_SELECTCONVERTTO Określa, że przycisk radiowy Konwertuj na zostanie wybrany początkowo po wywołaniu okna dialogowego. Jest to opcja domyślna.

• CF_SELECTACTIVATEAS Określa, że przycisk radiowy Aktywuj jako zostanie wybrany początkowo po wywołaniu okna dialogowego.

• CF_SETCONVERTDEFAULT Określa, że klasa, której CLSID jest określona przez clsidConvertDefault składową m_cv struktury, będzie używana jako domyślny wybór w polu listy klas po wybraniu przycisku radiowego Konwertuj na.

• CF_SETACTIVATEDEFAULT Określa, że klasa, której CLSID jest określona przez clsidActivateDefault składową m_cv struktury, będzie używana jako domyślny wybór w polu listy klas po wybraniu przycisku radiowego Aktywuj jako.

• CF_SHOWHELPBUTTON Określa, że przycisk Pomoc będzie wyświetlany po wywołaniu okna dialogowego.

Pclassid
Wskazuje identyfikator CLSID elementu, który ma zostać przekonwertowany lub aktywowany. Jeśli wartość NULL, zostanie użyty identyfikator CLSID skojarzony z elementem pItem .

pParentWnd
Wskazuje obiekt okna nadrzędnego lub właściciela (typu CWnd), do którego należy obiekt okna dialogowego. Jeśli ma wartość NULL, nadrzędne okno okna dialogowego jest ustawione na główne okno aplikacji.

Uwagi

Aby wyświetlić okno dialogowe, wywołaj funkcję DoModal .

Aby uzyskać więcej informacji, zobacz CLSID Key and the OLEUICONVERT structure (Klucz CLSID i struktura OLEUICONVERT).

COleConvertDialog::D oConvert

Wywołaj tę funkcję po pomyślnym powrocie z trybu DoModal, aby przekonwertować lub aktywować obiekt typu COleClientItem.

BOOL DoConvert(COleClientItem* pItem);

Parametry

pItem
Wskazuje element, który ma zostać przekonwertowany lub aktywowany. Nie można mieć wartości NULL.

Wartość zwracana

Bezzerowe, jeśli się powiedzie; w przeciwnym razie 0.

Uwagi

Element jest konwertowany lub aktywowany zgodnie z informacjami wybranymi przez użytkownika w oknie dialogowym Konwertowanie.

COleConvertDialog::D oModal

Wywołaj tę funkcję, aby wyświetlić okno dialogowe Konwertowanie OLE.

virtual INT_PTR DoModal();

Wartość zwracana

Stan ukończenia okna dialogowego. Jedna z następujących wartości:

• IDOK, jeśli okno dialogowe zostało pomyślnie wyświetlone.

• IDCANCEL, jeśli użytkownik anulował okno dialogowe.

• IDABORT, jeśli wystąpił błąd. Jeśli zwracana jest funkcja IDABORT, wywołaj funkcję składową COleDialog::GetLastError , aby uzyskać więcej informacji o typie błędu, który wystąpił. Aby uzyskać listę możliwych błędów, zobacz funkcję OleUIConvert w zestawie Windows SDK.

Uwagi

Jeśli chcesz zainicjować różne kontrolki okna dialogowego, ustawiając elementy członkowskie struktury m_cv , należy to zrobić przed wywołaniem DoModalmetody , ale po utworzeniu obiektu okna dialogowego.

Jeśli DoModal funkcja IDOK zwraca wartość IDOK, możesz wywołać inne funkcje członkowskie, aby pobrać ustawienia lub informacje wprowadzone przez użytkownika w oknie dialogowym.

COleConvertDialog::GetClassID

Wywołaj tę funkcję, aby pobrać identyfikator CLSID skojarzony z elementem wybranym przez użytkownika w oknie dialogowym Konwertuj.

REFCLSID GetClassID() const;

Wartość zwracana

Identyfikator CLSID skojarzony z elementem wybranym w oknie dialogowym Konwertuj.

Uwagi

Wywołaj tę funkcję dopiero wtedy, gdy funkcja DoModal zwróci element IDOK.

Aby uzyskać więcej informacji, zobacz CLSID Key in the Windows SDK (Klucz CLSID w zestawie WINDOWS SDK).

COleConvertDialog::GetDrawAspect

Wywołaj tę funkcję, aby określić, czy użytkownik zdecydował się wyświetlić wybrany element jako ikonę.

DVASPECT GetDrawAspect() const;

Wartość zwracana

Metoda wymagana do renderowania obiektu.

• DVASPECT_CONTENT zwrócone, jeśli pole wyboru Wyświetl jako nie zostało zaznaczone.

• DVASPECT_ICON zwrócone, jeśli pole wyboru Wyświetl jako ikonę zostało zaznaczone.

Uwagi

Wywołaj tę funkcję dopiero wtedy, gdy funkcja DoModal zwróci element IDOK.

Aby uzyskać więcej informacji na temat aspektu rysunku, zobacz strukturę danych FORMATETC w zestawie Windows SDK.

COleConvertDialog::GetIconicMetafile

Wywołaj tę funkcję, aby uzyskać dojście do metapliku zawierającego kultowy aspekt wybranego elementu.

HGLOBAL GetIconicMetafile() const;

Wartość zwracana

Uchwyt do metapliku zawierającego kultowy aspekt wybranego elementu, jeśli pole wyboru Wyświetl jako ikonę zostało zaznaczone, gdy okno dialogowe zostało odrzucone, wybierając przycisk OK; w przeciwnym razie wartość NULL.

COleConvertDialog::GetSelectionType

Wywołaj tę funkcję, aby określić typ konwersji wybranej w oknie dialogowym Konwertuj.

UINT GetSelectionType() const;

Wartość zwracana

Typ dokonanego wyboru.

Uwagi

Zwracane wartości typu są określane przez Selection typ wyliczenia zadeklarowany w COleConvertDialog klasie.

enum Selection {
    noConversion,
    convertItem,
    activateAs
    };

Poniżej przedstawiono krótkie opisy tych wartości:

• COleConvertDialog::noConversion Zwrócone, jeśli okno dialogowe zostało anulowane lub użytkownik nie wybrał konwersji. Jeśli COleConvertDialog::DoModal zostanie zwrócony element IDOK, możliwe, że użytkownik wybrał inną ikonę niż poprzednio wybrana.

• COleConvertDialog::convertItem Zwrócony, jeśli zaznaczono przycisk radiowy Konwertuj na, użytkownik wybrał inny element do konwersji na i DoModal zwrócił element IDOK.

• COleConvertDialog::activateAs Zwrócony, jeśli zaznaczono przycisk radiowy Aktywuj jako, użytkownik wybrał inny element do aktywowania i DoModal zwrócił element IDOK.

COleConvertDialog::m_cv

Struktura typu OLEUICONVERT używana do kontrolowania zachowania okna dialogowego Konwertuj.

OLEUICONVERT m_cv;

Uwagi

Elementy członkowskie tej struktury można modyfikować bezpośrednio lub za pomocą funkcji składowych.

Aby uzyskać więcej informacji, zobacz strukturę OLEUICONVERT w zestawie WINDOWS SDK.

Zobacz też

Klasa COleDialog
Wykres hierarchii
Klasa COleDialog