Klasa COleInsertDialog

Służy do wstawiania obiektu OLE okno dialogowe.

Składnia

class COleInsertDialog : public COleDialog

Elementy członkowskie

Konstruktory publiczne

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

Metody publiczne

Nazwa/nazwisko	opis
COleInsertDialog::CreateItem	Tworzy element wybrany w oknie dialogowym.
COleInsertDialog::D oModal	Wyświetla okno dialogowe Wstawianie obiektu OLE.
COleInsertDialog::GetClassID	Pobiera identyfikator CLSID skojarzony z wybranym elementem.
COleInsertDialog::GetDrawAspect	Informuje, czy element ma być rysowy jako ikona.
COleInsertDialog::GetIconicMetafile	Pobiera uchwyt do metapliku skojarzonego z kultową formą tego elementu.
COleInsertDialog::GetPathName	Pobiera pełną ścieżkę do pliku wybranego w oknie dialogowym.
COleInsertDialog::GetSelectionType	Pobiera wybrany typ obiektu.

Publiczne elementy członkowskie danych

Nazwa/nazwisko	opis
COleInsertDialog::m_io	Struktura typu OLEUIINSERTOBJECT, która kontroluje zachowanie okna dialogowego.

Uwagi

Utwórz obiekt klasy COleInsertDialog , gdy chcesz wywołać to okno dialogowe. Po skonstruowaniu COleInsertDialog obiektu można użyć struktury m_io , aby zainicjować wartości lub stany kontrolek w oknie dialogowym. Struktura m_io jest typu OLEUIINSERTOBJECT. Aby uzyskać więcej informacji na temat korzystania z tej klasy okna dialogowego, zobacz funkcję składową DoModal .

Uwaga

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

Aby uzyskać więcej informacji, zobacz strukturę OLEUIINSERTOBJECT w zestawie Windows SDK.

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

Hierarchia dziedziczenia

Obiekt CObject

CCmdTarget

CWnd

CDialog

CCommonDialog

COleDialog

COleInsertDialog

Wymagania

Nagłówek: afxodlgs.h

COleInsertDialog::COleInsertDialog

Ta funkcja konstruuje tylko COleInsertDialog obiekt.

COleInsertDialog (
    DWORD dwFlags = IOF_SELECTCREATENEW,
    CWnd* pParentWnd = NULL);

Parametry

dwFlags
Flaga tworzenia zawierająca dowolną liczbę następujących wartości do połączenia przy użyciu operatora bitowego OR:

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

• IOF_SELECTCREATENEW Określa, że przycisk radiowy Utwórz nowy zostanie wybrany początkowo po wywołaniu okna dialogowego. Jest to wartość domyślna i nie można jej używać z IOF_SELECTCREATEFROMFILE.

• IOF_SELECTCREATEFROMFILE Określa, że przycisk radiowy Utwórz z pliku zostanie wybrany początkowo po wywołaniu okna dialogowego. Nie można używać z IOF_SELECTCREATENEW.

• IOF_CHECKLINK Określa, że pole wyboru Łącze będzie początkowo zaznaczone po wywołaniu okna dialogowego.

• IOF_DISABLELINK Określa, że pole wyboru Łącze zostanie wyłączone po wywołaniu okna dialogowego.

• IOF_CHECKDISPLAYASICON Określa, że pole wyboru Ikona wyświetlania jako zostanie początkowo zaznaczone, zostanie wyświetlona bieżąca ikona, a przycisk Zmień ikonę zostanie włączony po wywołaniu okna dialogowego.

• IOF_VERIFYSERVERSEXIST Określa, że okno dialogowe powinno zweryfikować klasy, które dodaje do pola listy, upewniając się, że serwery określone w bazie danych rejestracji istnieją przed wyświetleniem okna dialogowego. Ustawienie tej flagi może znacznie obniżyć wydajność.

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 obiektu okna dialogowego jest ustawione na główne okno aplikacji.

Uwagi

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

COleInsertDialog::CreateItem

Wywołaj tę funkcję, aby utworzyć obiekt typu COleClientItem tylko wtedy, gdy funkcja DoModal zwraca element IDOK.

BOOL CreateItem(COleClientItem* pItem);

Parametry

pItem
Wskazuje element do utworzenia.

Wartość zwracana

Niezerowe, jeśli element został utworzony; w przeciwnym razie 0.

Uwagi

Przed wywołaniem tej funkcji należy przydzielić COleClientItem obiekt.

COleInsertDialog::D oModal

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

virtual INT_PTR
    DoModal();

INT_PTR
    DoModal(DWORD  dwFlags);

Parametry

dwFlags
Jedna z następujących wartości:

COleInsertDialog::DocObjectsOnly Wstawia tylko obiekty DocObject.

COleInsertDialog::ControlsOnly wstawia tylko kontrolki ActiveX.

Zero nie wstawia ani kontrolki DocObject, ani kontrolki ActiveX. Ta wartość powoduje wykonanie tej samej implementacji co pierwszy prototyp wymieniony powyżej.

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ę OleUIInsertObject w zestawie SDK systemu Windows.

Uwagi

Jeśli chcesz zainicjować różne kontrolki okna dialogowego, ustawiając elementy członkowskie struktury m_io , 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 wejściowe do okna dialogowego przez użytkownika.

COleInsertDialog::GetClassID

Wywołaj tę funkcję, aby uzyskać identyfikator CLSID skojarzony z wybranym elementem tylko wtedy, gdy funkcja DoModal zwraca element IDOK, a typ wyboru to COleInsertDialog::createNewItem.

REFCLSID GetClassID() const;

Wartość zwracana

Zwraca identyfikator CLSID skojarzony z wybranym elementem.

Uwagi

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

COleInsertDialog::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ę tylko wtedy, gdy funkcja DoModal zwraca element IDOK.

Aby uzyskać więcej informacji na temat aspektu rysunku, zobacz FORMATETC data structure in the Windows SDK (Struktura danych FORMATETC w zestawie Windows SDK).

COleInsertDialog::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 Ikona wyświetlania jako zostało zaznaczone, gdy okno dialogowe zostało odrzucone, wybierając przycisk OK; w przeciwnym razie wartość NULL.

COleInsertDialog::GetPathName

Wywołaj tę funkcję, aby uzyskać pełną ścieżkę wybranego pliku tylko wtedy, gdy funkcja DoModal zwraca wartość IDOK, a typ wyboru nie COleInsertDialog::createNewItemjest .

CString GetPathName() const;

Wartość zwracana

Pełna ścieżka do pliku wybranego w oknie dialogowym. Jeśli typ wyboru to createNewItem, ta funkcja zwraca bez CString znaczenia w trybie wydania lub powoduje asercji w trybie debugowania.

COleInsertDialog::GetSelectionType

Wywołaj tę funkcję, aby uzyskać typ wyboru wybrany, gdy okno dialogowe Wstaw obiekt zostało odrzucone, wybierając przycisk OK.

UINT GetSelectionType() const;

Wartość zwracana

Typ dokonanego wyboru.

Uwagi

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

enum Selection {
    createNewItem,
    insertFromFile,
    linkToFile
    };

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

• COleInsertDialog::createNewItem Wybrano przycisk radiowy Utwórz nowy.

• COleInsertDialog::insertFromFile Przycisk radiowy Utwórz z pliku został wybrany, a pole wyboru Łącze nie zostało zaznaczone.

• COleInsertDialog::linkToFile Zaznaczono przycisk radiowy Utwórz z pliku, a pole wyboru Łącze zostało zaznaczone.

COleInsertDialog::m_io

Struktura typu OLEUIINSERTOBJECT używana do kontrolowania zachowania okna dialogowego Wstawianie obiektu.

OLEUIINSERTOBJECT m_io;

Uwagi

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

Aby uzyskać więcej informacji, zobacz strukturę OLEUIINSERTOBJECT w zestawie Windows SDK.

Zobacz też

Przykład MFC OCLIENT
Klasa COleDialog
Wykres hierarchii
Klasa COleDialog