OleUIPasteSpecialA-Funktion (oledlg.h)

Artikel
11/20/2024

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

Syntax

UINT OleUIPasteSpecialA(
  [in] LPOLEUIPASTESPECIALA unnamedParam1
);

Parameter

[in] unnamedParam1

Ein Zeiger auf eine OLEUIPASTESPECIAL Struktur.

Rückgabewert

Standard-Erfolgs-/Fehlerdefinitionen

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

Standardfeldüberprüfungsfehler

Rückgabecode	Beschreibung
OLEUI_ERR_STANDARDMIN	Fehler, die für alle Dialogfelder üblich sind, liegen im Bereich OLEUI_ERR_STANDARDMIN, um 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 wird, war NULL-.
OLEUI_ERR_STRUCTUREINVALID	Unzureichende Berechtigungen für Lese- oder Schreibzugriff auf eine OLEUIXXX-Struktur.
OLEUI_ERR_CBSTRUCTINCORRECT	Der wert cbstruct 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 wert lpszTemplate 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 Initialisierung des Dialogfelds.
OLEUI_ERR_LOCALMEMALLOC	Fehler beim Aufruf LocalAlloc- oder des Standard-IMalloc Allocator.
OLEUI_ERR_GLOBALMEMALLOC	Fehler beim Aufruf von GlobalAlloc oder der Standard-IMalloc Allocator.
OLEUI_ERR_LOADSTRING	LoadString- kann nicht aufgerufen werden, um lokalisierte Ressourcen aus der Bibliothek abzurufen.
OLEUI_ERR_OLEMEMALLOC	Fehler beim Aufruf des Standard-IMalloc Allocator.

Funktionsspezifische Fehler

Rückgabecode	Beschreibung
OLEUI_ERR_STANDARDMAX	Fehler, die für alle Dialogfelder üblich sind, liegen im Bereich OLEUI_ERR_STANDARDMIN, um OLEUI_ERR_STANDARDMAX. Mit diesem Wert kann die Anwendung auf Standardmeldungen testen, um dem Benutzer Fehlermeldungen anzuzeigen.
OLEUI_IOERR_SRCDATAOBJECTINVALID	Das lpSrcDataObject- Mitglied OLEUIPASTESPECIAL- ist ungültig.
OLEUI_IOERR_ARRPASTEENTRIESINVALID	Das arrPasteEntries Mitglied von OLEUIPASTESPECIAL ist ungültig.
OLEUI_IOERR_ARRLINKTYPESINVALID	Das arrLinkTypes- Mitglied 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 Member ist falsch.

Bemerkungen

Der Entwurf des Dialogfelds Inhalte einfügen geht davon aus, dass Sie, wenn Sie es einem Benutzer gestatten möchten, eine Verknüpfung mit einem Objekt zu ermöglichen, auch bereit sind, dem Benutzer das Einbetten dieses Objekts zu gestatten. Wenn eines der OLEUIPASTE_LINKTYPE Flags festgelegt ist, die dem OLEUIPASTEFLAG Enumeration zugeordnet sind, muss das OLEUIPASTE_PASTE Flag auch so festgelegt werden, dass die Datenformate im Dialogfeld Inhalte einfügen angezeigt werden.

Der text, der im Feld Source field of the standard Paste Special dialog box, which is implemented in Oledlg32.dll, is the null-terminated string whose offset in bytes is specified in the dwSrcofCopy member of the OBJECTDESCRIPTOR structure for the object to be pasteed. Wenn ein OBJECTDESCRIPTOR- Struktur für dieses Objekt nicht verfügbar ist, zeigt das Dialogfeld den Text an, der CF_LINKSOURCEDESCRIPTOR zugeordnet werden kann. Wenn keine struktur verfügbar ist, wird im Dialogfeld nach CF_FILENAME gesucht. Wenn CF_FILENAME nicht gefunden wird, zeigt das Dialogfeld die Zeichenfolge "Unbekannte Quelle" an.

Wenn Sie ein HMETAFILEPICT- freizugeben, das vom Dialogfeld Objekt einfügen oder Dialogfeld "Inhalte 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);
    }
}

Anmerkung

Der oledlg.h-Header definiert OLEUIPASTESPECIAL als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	oledlg.h
Library	OleDlg.lib
DLL-	OleDlg.dll

Siehe auch

OLEUIPASTEFLAG-

Freigeben über