OleUIPasteSpecialW-Funktion (oledlg.h)

Artikel
03/01/2024

Ruft das Standarddialogfeld Spezial einfügen auf, sodass der Benutzer das Format des Zwischenablageobjekts auswählen kann, das eingefügt oder eingefügt werden soll.

Syntax

UINT OleUIPasteSpecialW(
  [in] LPOLEUIPASTESPECIALW unnamedParam1
);

Parameter

[in] unnamedParam1

Ein Zeiger auf eine OLEUIPASTESPECIAL-Struktur .

Rückgabewert

Standarddefinitionen für Erfolg/Fehler

Rückgabecode	Beschreibung
OLEUI_FALSE	Unbekannter Fehler (nicht verwendet).
OLEUI_OK	Der Benutzer hat die Schaltfläche OK gedrückt.
OLEUI_SUCCESS	Kein Fehler, wie OLEUI_OK.
OLEUI_CANCEL	Der Benutzer hat die Schaltfläche Abbrechen gedrückt.

Standardfeldvalidierungsfehler

Rückgabecode	Beschreibung
OLEUI_ERR_STANDARDMIN	Fehler, die für alle Dialogfelder gemeinsam sind, liegen im Bereich OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Mit diesem Wert kann die Anwendung auf Standardmeldungen testen, um dem Benutzer Fehlermeldungen anzuzeigen.
OLEUI_ERR_STRUCTURENULL	Der Zeiger auf eine OLEUIXXX-Struktur, die an die Funktion übergeben wurde, war NULL.
OLEUI_ERR_STRUCTUREINVALID	Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur.
OLEUI_ERR_CBSTRUCTINCORRECT	Der cbstruct-Wert ist falsch.
OLEUI_ERR_HWNDOWNERINVALID	Der hWndOwner-Wert ist ungültig.
OLEUI_ERR_LPSZCAPTIONINVALID	Der lpszCaption-Wert ist ungültig.
OLEUI_ERR_LPFNHOOKINVALID	Der lpfnHook-Wert ist ungültig.
OLEUI_ERR_HINSTANCEINVALID	Der hInstance-Wert ist ungültig.
OLEUI_ERR_LPSZTEMPLATEINVALID	Der lpszTemplate-Wert ist ungültig.
OLEUI_ERR_HRESOURCEINVALID	Der hResource-Wert ist ungültig.

Initialisierungsfehler

Rückgabecode	Beschreibung
OLEUI_ERR_FINDTEMPLATEFAILURE	Die Dialogfeldvorlage konnte nicht gefunden werden.
OLEUI_ERR_LOADTEMPLATEFAILURE	Die Dialogfeldvorlage kann nicht geladen werden.
OLEUI_ERR_DIALOGFAILURE	Fehler bei der Dialogfeldinitialisierung.
OLEUI_ERR_LOCALMEMALLOC	Ein Aufruf von LocalAlloc oder der IMalloc-Standardzuweisung ist fehlgeschlagen.
OLEUI_ERR_GLOBALMEMALLOC	Fehler beim Aufruf von GlobalAlloc oder der IMalloc-Standardzuweisung .
OLEUI_ERR_LOADSTRING	LoadString kann nicht aufgerufen werden, um lokalisierte Ressourcen aus der Bibliothek abzurufen.
OLEUI_ERR_OLEMEMALLOC	Fehler beim Aufruf der IMalloc-Standardzuweisung .

Funktionsspezifische Fehler

Rückgabecode	Beschreibung
OLEUI_ERR_STANDARDMAX	Fehler, die für alle Dialogfelder gemeinsam sind, liegen im Bereich OLEUI_ERR_STANDARDMIN OLEUI_ERR_STANDARDMAX. Mit diesem Wert kann die Anwendung auf Standardmeldungen testen, um dem Benutzer Fehlermeldungen anzuzeigen.
OLEUI_IOERR_SRCDATAOBJECTINVALID	Das lpSrcDataObject-Element von OLEUIPASTESPECIAL ist ungültig.
OLEUI_IOERR_ARRPASTEENTRIESINVALID	Das arrPasteEntries-Element von OLEUIPASTESPECIAL ist ungültig.
OLEUI_IOERR_ARRLINKTYPESINVALID	Das arrLinkTypes-Element von OLEUIPASTESPECIAL ist ungültig.
OLEUI_PSERR_CLIPBOARDCHANGED	Der Inhalt der Zwischenablage wurde geändert, während das Dialogfeld angezeigt wurde.
OLEUI_PSERR_GETCLIPBOAARDFAILED	Das lpSrcDataObj-Element ist falsch.

Hinweise

Beim Entwurf des Dialogfelds "Spezial einfügen " wird davon ausgegangen, dass Sie auch bereit sind, dem Benutzer das Einbetten dieses Objekts zu gestatten, wenn Sie bereit sind, einem Benutzer die Verknüpfung mit einem Objekt zu gestatten. Wenn eines der OLEUIPASTE_LINKTYPE Flags festgelegt ist, die der OLEUIPASTEFLAG-Enumeration zugeordnet sind, muss daher auch das flag OLEUIPASTE_PASTE festgelegt werden, damit die Datenformate im Dialogfeld Spezial einfügen angezeigt werden.

Der Text, der im Feld Quelle des Standardmäßigen Dialogfelds "Spezial einfügen " angezeigt wird, das in Oledlg32.dll implementiert ist, ist die NULL-endende Zeichenfolge, deren Offset in Bytes im dwSrcofCopy-Element der OBJECTDESCRIPTOR-Struktur für das einzufügende Objekt angegeben wird. Wenn für dieses Objekt keine OBJECTDESCRIPTOR-Struktur verfügbar ist, wird im Dialogfeld der beliebige Text angezeigt, der CF_LINKSOURCEDESCRIPTOR zugeordnet ist. Wenn keine struktur verfügbar ist, sucht das Dialogfeld nach CF_FILENAME. Wenn CF_FILENAME nicht gefunden wird, wird im Dialogfeld die Zeichenfolge "Unbekannte Quelle" angezeigt.

Um eine HMETAFILEPICT freizugeben, die aus dem Dialogfeld Objekt einfügen oder Spezial einfügen zurückgegeben wird, löschen Sie die angefügte Metadatei auf dem Handle wie folgt.

void FreeHmetafilepict(HMETAFILEPICT hmfp)
{
    if (hmfp != NULL)
    {
        LPMETAFILEPICT pmfp = GlobalLock(hmfp);
 
        DeleteMetaFile(pmfp->hMF);
        GlobalUnlock(hmfp);
        GlobalFree(hmfp);
    }
    else
    {
        // Handle null pointers here.
        exit(0);
    }
}

Hinweis

Der oledlg.h-Header definiert OLEUIPASTESPECIAL als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oledlg.h
Bibliothek	OleDlg.lib
DLL	OleDlg.dll

Weitere Informationen

OLEUIPASTEFLAG

Freigeben über