Udostępnij za pośrednictwem

Klasa COlePasteSpecialDialog

  • Artykuł

Służy do wklejania OLE specjalne okno dialogowe.

Składnia

class COlePasteSpecialDialog : public COleDialog

Elementy członkowskie

Konstruktory publiczne

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

Metody publiczne

Nazwa/nazwisko opis
COlePasteSpecialDialog::AddFormat Dodaje niestandardowe formaty do listy formatów, które aplikacja może wkleić.
COlePasteSpecialDialog::AddLinkEntry Dodaje nowy wpis do listy obsługiwanych formatów Schowka.
COlePasteSpecialDialog::AddStandardFormats Dodaje CF_BITMAP, CF_DIB, CF_METAFILEPICT i opcjonalnie CF_LINKSOURCE do listy formatów, które aplikacja może wkleić.
COlePasteSpecialDialog::CreateItem Tworzy element w dokumencie kontenera przy użyciu określonego formatu.
COlePasteSpecialDialog::D oModal Wyświetla okno dialogowe Ole Paste Special (Specjalne wklejanie OLE).
COlePasteSpecialDialog::GetDrawAspect Informuje, czy element ma być rysowy jako ikona, czy nie.
COlePasteSpecialDialog::GetIconicMetafile Pobiera uchwyt do metapliku skojarzonego z kultową formą tego elementu.
COlePasteSpecialDialog::GetPasteIndex Pobiera indeks dostępnych opcji wklejania wybranych przez użytkownika.
COlePasteSpecialDialog::GetSelectionType Pobiera wybrany typ zaznaczenia.

Publiczne elementy członkowskie danych

Nazwa/nazwisko opis
COlePasteSpecialDialog::m_ps Struktura typu OLEUIPASTESPECIAL, która kontroluje funkcję okna dialogowego.

Uwagi

Utwórz obiekt klasy COlePasteSpecialDialog , gdy chcesz wywołać to okno dialogowe. Po utworzeniu COlePasteSpecialDialog obiektu można użyć funkcji składowych AddFormat i AddStandardFormats , aby dodać formaty Schowka do okna dialogowego. Możesz również użyć struktury m_ps , aby zainicjować wartości lub stany kontrolek w oknie dialogowym. Struktura m_ps jest typu OLEUIPASTESPECIAL.

Aby uzyskać więcej informacji, zobacz strukturę OLEUIPASTESPECIAL 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

COlePasteSpecialDialog

Wymagania

Nagłówek: afxodlgs.h

COlePasteSpecialDialog::AddFormat

Wywołaj tę funkcję, aby dodać nowe formaty do listy formatów, które aplikacja może obsługiwać w operacji wklejania specjalnej.

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
Odwołanie do typu danych do dodania.

lpszFormat
Ciąg opisujący format użytkownika.

lpszResult
Ciąg opisujący wynik, jeśli ten format zostanie wybrany w oknie dialogowym.

Flagi
Różne opcje łączenia i osadzania dostępne dla tego formatu. Ta flaga jest bitową kombinacją co najmniej jednej z różnych wartości w wyliczonym typie OLEUIPASTEFLAG.

por
Format schowka do dodania.

tymed
Typy multimediów dostępne w tym formacie. Jest to bitowa kombinacja co najmniej jednej wartości w wyliczonym typie TYMED.

nFormatID
Identyfikator ciągu identyfikującego ten format. Format tego ciągu to dwa oddzielne ciągi oddzielone znakiem "\n". Pierwszy ciąg jest taki sam, który zostanie przekazany w parametrze lpstrFormat , a drugi jest taki sam jak parametr lpstrResult .

bEnableIcon
Flaga określająca, czy pole wyboru Wyświetl jako ikona jest włączone po wybraniu tego formatu w polu listy.

mrugać
Flaga określająca, czy przycisk radiowy Wklej łącze jest włączony po wybraniu tego formatu w polu listy.

Uwagi

Tę funkcję można wywołać, aby dodać standardowe formaty, takie jak CF_TEXT lub CF_TIFF lub niestandardowe formaty zarejestrowane przez aplikację w systemie. Aby uzyskać więcej informacji na temat wklejania obiektów danych do aplikacji, zobacz artykuł Obiekty danych i źródła danych: manipulowanie.

Aby uzyskać więcej informacji, zobacz typ wyliczenia TYMED i strukturę FORMATETC w zestawie SDK systemu Windows.

Aby uzyskać więcej informacji, zobacz typ wyliczany OLEUIPEFLAG w zestawie WINDOWS SDK.

COlePasteSpecialDialog::AddLinkEntry

Dodaje nowy wpis do listy obsługiwanych formatów Schowka.

OLEUIPASTEFLAG AddLinkEntry(UINT cf);

Parametry

por
Format schowka do dodania.

Wartość zwracana

Struktura OLEUIPASTEFLAG zawierająca informacje dotyczące nowego wpisu linku.

COlePasteSpecialDialog::AddStandardFormats

Wywołaj tę funkcję, aby dodać następujące formaty Schowka do listy formatów, które aplikacja może obsługiwać w operacji wklejania specjalnej:

void AddStandardFormats(BOOL bEnableLink = TRUE);

Parametry

bEnableLink
Flaga określająca, czy dodać CF_LINKSOURCE do listy formatów, które aplikacja może wkleić.

Uwagi

  • CF_BITMAP

  • CF_DIB

  • CF_METAFILEPICT

  • "Obiekt osadzony"

  • (opcjonalnie) " Źródło łącza"

Te formaty są używane do obsługi osadzania i łączenia.

COlePasteSpecialDialog::COlePasteSpecialDialog

COlePasteSpecialDialog Tworzy obiekt.

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

Parametry

dwFlags
Flaga tworzenia zawiera dowolną liczbę następujących flag połączonych przy użyciu operatora bitowego OR:

  • PSF_SELECTPASTE Określa, że przycisk radiowy Wklej będzie początkowo sprawdzany po wywołaniu okna dialogowego. Nie można używać w połączeniu z PSF_SELECTPASTELINK. Jest to opcja domyślna.

  • PSF_SELECTPASTELINK Określa, że przycisk radiowy Wklej łącze będzie początkowo sprawdzany po wywołaniu okna dialogowego. Nie można używać w połączeniu z PSF_SELECTPASTE.

  • PSF_CHECKDISPLAYASICON Określa, że pole wyboru Ikona wyświetlania jako będzie zaznaczone początkowo po wywołaniu okna dialogowego.

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

pDataObject
Wskazuje obiekt COleDataObject do wklejania. Jeśli ta wartość ma wartość NULL, pobiera wartość COleDataObject ze Schowka.

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

Ta funkcja konstruuje COlePasteSpecialDialog tylko obiekt. Aby wyświetlić okno dialogowe, wywołaj funkcję DoModal .

Aby uzyskać więcej informacji, zobacz typ wyliczany OLEUIPEFLAG w zestawie WINDOWS SDK.

COlePasteSpecialDialog::CreateItem

Tworzy nowy element wybrany w oknie dialogowym Wklej specjalne.

BOOL CreateItem(COleClientItem* pNewItem);

Parametry

pNewItem
COleClientItem Wskazuje wystąpienie. Nie można mieć wartości NULL.

Wartość zwracana

Nonzero, jeśli element został utworzony pomyślnie; w przeciwnym razie 0.

Uwagi

Ta funkcja powinna być wywoływana tylko wtedy, gdy funkcja DoModal zwraca element IDOK.

COlePasteSpecialDialog::D oModal

Wyświetla okno dialogowe Ole Paste Special (Specjalne wklejanie 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ę OleUIPasteSpecial w zestawie Windows SDK.

Uwagi

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

COlePasteSpecialDialog::GetDrawAspect

Określa, 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 ikona nie zostało zaznaczone, gdy okno dialogowe zostało odrzucone.

  • DVASPECT_ICON Zwrócone, jeśli pole wyboru Wyświetl jako ikonę zostało zaznaczone po odrzuceniu okna dialogowego.

Uwagi

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

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

COlePasteSpecialDialog::GetIconicMetafile

Pobiera metaplik skojarzony z elementem wybranym przez użytkownika.

HGLOBAL GetIconicMetafile() const;

Wartość zwracana

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

COlePasteSpecialDialog::GetPasteIndex

Pobiera wartość indeksu skojarzoną z wpisem wybranym przez użytkownika.

int GetPasteIndex() const;

Wartość zwracana

Indeks do tablicy OLEUIPASTEENTRY struktur wybranych przez użytkownika. Format odpowiadający wybranemu indeksowi powinien być używany podczas wykonywania operacji wklejania.

Uwagi

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

COlePasteSpecialDialog::GetSelectionType

Określa typ wyboru dokonanego przez użytkownika.

UINT GetSelectionType() const;

Wartość zwracana

Zwraca typ dokonanego wyboru.

Uwagi

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

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

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

  • COlePasteSpecialDialog::pasteLink Przycisk radiowy Wklej łącze został zaznaczony, a wybrany format był standardowym formatem OLE.

  • COlePasteSpecialDialog::pasteNormal Przycisk radiowy Wklej został zaznaczony, a wybrany format był standardowym formatem OLE.

  • COlePasteSpecialDialog::pasteOther Wybrany format nie jest standardowym formatem OLE.

  • COlePasteSpecialDialog::pasteStatic Wybrany format to metaplik.

COlePasteSpecialDialog::m_ps

Struktura typu OLEUIPASTESPECIAL używana do kontrolowania zachowania okna dialogowego Wklej specjalne.

OLEUIPASTESPECIAL m_ps;

Uwagi

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

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

Zobacz też

Przykład MFC OCLIENT
Klasa COleDialog
Wykres hierarchii
Klasa COleDialog