Partager via


OleUIPasteSpecialW, fonction (oledlg.h)

Appelle la boîte de dialogue Coller spécial standard, ce qui permet à l’utilisateur de sélectionner le format de l’objet presse-papiers à coller ou coller.

Syntaxe

UINT OleUIPasteSpecialW(
  [in] LPOLEUIPASTESPECIALW unnamedParam1
);

Paramètres

[in] unnamedParam1

Pointeur vers une structure OLEUIPASTESPECIAL .

Valeur retournée

Définitions de réussite/d’erreur standard

Code de retour Description
OLEUI_FALSE
Échec inconnu (inutilisé).
OLEUI_OK
L’utilisateur a appuyé sur le bouton OK.
OLEUI_SUCCESS
Aucune erreur, identique à OLEUI_OK.
OLEUI_CANCEL
L’utilisateur a appuyé sur le bouton Annuler.
 

Erreurs de validation de champ standard

Code de retour Description
OLEUI_ERR_STANDARDMIN
Les erreurs communes à toutes les boîtes de dialogue se trouvent dans la plage OLEUI_ERR_STANDARDMIN à OLEUI_ERR_STANDARDMAX. Cette valeur permet à l’application de tester les messages standard afin d’afficher les messages d’erreur à l’utilisateur.
OLEUI_ERR_STRUCTURENULL
Le pointeur vers une structure OLEUIXXX passée dans la fonction était NULL.
OLEUI_ERR_STRUCTUREINVALID
Autorisations insuffisantes pour l’accès en lecture ou en écriture à une structure OLEUIXXX.
OLEUI_ERR_CBSTRUCTINCORRECT
La valeur cbstruct est incorrecte.
OLEUI_ERR_HWNDOWNERINVALID
La valeur hWndOwner n’est pas valide.
OLEUI_ERR_LPSZCAPTIONINVALID
La valeur lpszCaption n’est pas valide.
OLEUI_ERR_LPFNHOOKINVALID
La valeur lpfnHook n’est pas valide.
OLEUI_ERR_HINSTANCEINVALID
La valeur hInstance n’est pas valide.
OLEUI_ERR_LPSZTEMPLATEINVALID
La valeur lpszTemplate n’est pas valide.
OLEUI_ERR_HRESOURCEINVALID
La valeur hResource n’est pas valide.
 

Erreurs d’initialisation

Code de retour Description
OLEUI_ERR_FINDTEMPLATEFAILURE
Impossible de trouver le modèle de boîte de dialogue.
OLEUI_ERR_LOADTEMPLATEFAILURE
Impossible de charger le modèle de boîte de dialogue.
OLEUI_ERR_DIALOGFAILURE
Échec de l’initialisation de la boîte de dialogue.
OLEUI_ERR_LOCALMEMALLOC
Un appel à LocalAlloc ou à l’allocator IMalloc standard a échoué.
OLEUI_ERR_GLOBALMEMALLOC
Un appel à GlobalAlloc ou à l’allocateur IMalloc standard a échoué.
OLEUI_ERR_LOADSTRING
Impossible d’appeler LoadString pour obtenir des ressources localisées à partir de la bibliothèque.
OLEUI_ERR_OLEMEMALLOC
Un appel à l’allocateur IMalloc standard a échoué.
 

Erreurs spécifiques à la fonction

Code de retour Description
OLEUI_ERR_STANDARDMAX
Les erreurs communes à toutes les boîtes de dialogue se trouvent dans la plage OLEUI_ERR_STANDARDMIN à OLEUI_ERR_STANDARDMAX. Cette valeur permet à l’application de tester les messages standard afin d’afficher les messages d’erreur à l’utilisateur.
OLEUI_IOERR_SRCDATAOBJECTINVALID
Le membre lpSrcDataObjectd’OLEUIPASTESPECIAL n’est pas valide.
OLEUI_IOERR_ARRPASTEENTRIESINVALID
Le membre arrPasteEntriesd’OLEUIPASTESPECIAL n’est pas valide.
OLEUI_IOERR_ARRLINKTYPESINVALID
Le membre arrLinkTypesd’OLEUIPASTESPECIAL n’est pas valide.
OLEUI_PSERR_CLIPBOARDCHANGED
Le contenu du Presse-papiers a changé lors de l’affichage de la boîte de dialogue.
OLEUI_PSERR_GETCLIPBOAARDFAILED

Le membre lpSrcDataObj est incorrect.

Remarques

La conception de la boîte de dialogue Coller spécial suppose que si vous êtes prêt à autoriser un utilisateur à créer un lien vers un objet, vous êtes également prêt à autoriser l’utilisateur à incorporer cet objet. Pour cette raison, si l’un des indicateurs de OLEUIPASTE_LINKTYPE associés à l’énumération OLEUIPASTEFLAG est défini, l’indicateur OLEUIPASTE_PASTE doit également être défini pour que les formats de données s’affichent dans la boîte de dialogue Coller spécial .

Le texte affiché dans le champ Source de la boîte de dialogue Coller spécial standard, qui est implémentée dans Oledlg32.dll, est la chaîne terminée par null dont le décalage en octets est spécifié dans le membre dwSrcofCopy de la structure OBJECTDESCRIPTOR pour l’objet à coller. Si aucune structure OBJECTDESCRIPTOR n’est disponible pour cet objet, la boîte de dialogue affiche le texte qui peut être associé à CF_LINKSOURCEDESCRIPTOR. Si aucune structure n’est disponible, la boîte de dialogue recherche CF_FILENAME. Si CF_FILENAME est introuvable, la boîte de dialogue affiche la chaîne « Source inconnue ».

Pour libérer un OBJET HMETAFILEPICT renvoyé à partir de la boîte de dialogue Insérer un objet ou Coller un objet spécial , supprimez le métafichier attaché sur le handle, comme suit.

 
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 

Notes

L’en-tête oledlg.h définit OLEUIPASTESPECIAL comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête oledlg.h
Bibliothèque OleDlg.lib
DLL OleDlg.dll

Voir aussi

OLEUIPASTEFLAG