OleUIPasteSpecialA-Funktion (oledlg.h)

  • Artikel

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

Syntax

UINT OleUIPasteSpecialA(
  [in] LPOLEUIPASTESPECIALA 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, 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 allen Dialogfeldern 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-Standardzuteilung ist fehlgeschlagen.
OLEUI_ERR_GLOBALMEMALLOC
 Fehler beim Aufruf von GlobalAlloc oder dem IMalloc-Standardzuteilungsmodul.
OLEUI_ERR_LOADSTRING
 LoadString kann nicht aufgerufen werden, um lokalisierte Ressourcen aus der Bibliothek abzurufen.
OLEUI_ERR_OLEMEMALLOC
 Fehler beim Aufruf des IMalloc-Standardzuteilungsmoduls.
 

Funktionsspezifische Fehler

Rückgabecode Beschreibung
OLEUI_ERR_STANDARDMAX
 Fehler, die allen Dialogfeldern 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 hat sich 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 Objekt zu gestatten, wenn Sie einem Benutzer erlauben, eine Verknüpfung mit einem Objekt zu erstellen. Wenn aus diesem Grund eines der OLEUIPASTE_LINKTYPE Flags festgelegt wird, die der OLEUIPASTEFLAG-Enumeration zugeordnet sind, muss auch das OLEUIPASTE_PASTE-Flag festgelegt werden, damit die Datenformate im Dialogfeld Spezial einfügen angezeigt werden.

Der Text, der im Feld Quelle des Standarddialogfelds Spezial einfügen angezeigt wird, das in Oledlg32.dll implementiert wird, ist die null-beendete Zeichenfolge, deren Offset in Bytes im dwSrcofCopy-Element der OBJECTDESCRIPTOR-Struktur für das zu einfügende Objekt angegeben wird. Wenn für dieses Objekt keine OBJECTDESCRIPTOR-Struktur verfügbar ist, zeigt das Dialogfeld den Text an, der möglicherweise 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);
        }
}  // FreeHmetafilepict

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 nicht codierungsneutralem Code 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