Structure OLEUIPASTESPECIALW (oledlg.h)

Article
03/04/2024

Contient des informations que la bibliothèque d’interface utilisateur OLE utilise pour initialiser la boîte de dialogue Coller spécial , ainsi que de l’espace pour que la bibliothèque retourne des informations lorsque la boîte de dialogue est ignorée.

Syntaxe

typedef struct tagOLEUIPASTESPECIALW {
  DWORD              cbStruct;
  DWORD              dwFlags;
  HWND               hWndOwner;
  LPCWSTR            lpszCaption;
  LPFNOLEUIHOOK      lpfnHook;
  LPARAM             lCustData;
  HINSTANCE          hInstance;
  LPCWSTR            lpszTemplate;
  HRSRC              hResource;
  LPDATAOBJECT       lpSrcDataObj;
  LPOLEUIPASTEENTRYW arrPasteEntries;
  int                cPasteEntries;
  UINT               *arrLinkTypes;
  int                cLinkTypes;
  UINT               cClsidExclude;
  LPCLSID            lpClsidExclude;
  int                nSelectedIndex;
  BOOL               fLink;
  HGLOBAL            hMetaPict;
  SIZEL              sizel;
} OLEUIPASTESPECIALW, *POLEUIPASTESPECIALW, *LPOLEUIPASTESPECIALW;

Membres

cbStruct

Taille de la structure, en octets. Ce membre doit être renseigné lors de l’entrée.

dwFlags

Lors de l’entrée, dwFlags spécifie les indicateurs d’initialisation et de création. Lors de la sortie, il spécifie les choix de l’utilisateur. Il peut s’agir d’une combinaison des indicateurs suivants.

Valeur	Signification
PSF_SHOWHELP	La boîte de dialogue affiche un bouton Aide .
PSF_SELECTPASTE	La case d’option Coller est sélectionnée au démarrage de la boîte de dialogue. Il s’agit de la valeur par défaut, si PSF_SELECTPASTE ou PSF_SELECTPASTELINK ne sont pas spécifiés. En outre, il spécifie l’état du bouton lors de l’arrêt de la boîte de dialogue. Indicateur IN/OUT.
PSF_SELECTPASTELINK	La case d’option PasteLink est sélectionnée au démarrage de la boîte de dialogue. Spécifie également l’état du bouton lors de l’arrêt de la boîte de dialogue. Indicateur IN/OUT.
PSF_CHECKDISPLAYASICON	Indique si la case d’option Afficher l’icône a été cochée lors de l’arrêt de la boîte de dialogue. Indicateur OUT.
PSF_DISABLEDISPLAYASICON	La zone De case activée Icône d’affichage est désactivée lors de l’initialisation.
HIDECHANGEICON	Permet de désactiver le bouton d’icône de modification dans la boîte de dialogue, qui est disponible pour les utilisateurs lorsqu’ils collent un objet OLE par défaut. Sinon , consultez STAYONCLIPBOARDCHANGE .
STAYONCLIPBOARDCHANGE	Permet d’indiquer à la boîte de dialogue de rester en place si le Presse-papiers change lorsque la boîte de dialogue est activée. Si l’utilisateur bascule vers une autre application et copie ou coupe quelque chose, la boîte de dialogue effectue par défaut une opération d’annulation, qui supprime la boîte de dialogue, car les options qu’elle présente à l’utilisateur ne sont plus à jour par rapport à ce qui se trouve réellement dans le Presse-papiers.
NOREFRESHDATAOBJECT	Utilisé conjointement avec STAYONCLIPBOARDCHANGE (il ne fait rien autrement). Si le Presse-papiers change alors que la boîte de dialogue est en place et que STAYONCLIPBOARDCHANGE est spécifié, NOREFRESHDATAOBJECT indique que la boîte de dialogue ne doit PAS actualiser le contenu de la boîte de dialogue pour refléter le nouveau contenu du Presse-papiers. Cela est utile si l’application utilise la boîte de dialogue collage spécial sur un objet IDataObject en plus de celle du Presse-papiers, par exemple, dans le cadre d’une opération de glisser-déplacer avec le bouton droit.

hWndOwner

Fenêtre qui possède la boîte de dialogue. Ce membre ne doit pas avoir la valeur NULL.

lpszCaption

Pointeur vers une chaîne à utiliser comme titre de la boîte de dialogue. Si la valeur est NULL, la bibliothèque utilise Collage spécial.

lpfnHook

Pointeur vers une fonction de raccordement qui traite les messages destinés à la boîte de dialogue. La fonction hook doit retourner zéro pour transmettre un message qu’elle n’a pas retransmise à la procédure de boîte de dialogue dans la bibliothèque. La fonction hook doit retourner une valeur différente de zéro pour empêcher la procédure de boîte de dialogue de la bibliothèque de traiter un message qu’elle a déjà traité.

lCustData

Données définies par l’application que la bibliothèque transmet à la fonction hook pointée par le membre lpfnHook . La bibliothèque transmet un pointeur à la structure OLEUIPASTESPECIAL dans le paramètre lParam du message WM_INITDIALOG ; ce pointeur peut être utilisé pour récupérer le membre lCustData .

hInstance

Instance qui contient un modèle de boîte de dialogue spécifié par le membre lpTemplateName .

lpszTemplate

Pointeur vers une chaîne terminée par null qui spécifie le nom du fichier de ressources pour le modèle de boîte de dialogue qui doit être remplacé par le modèle de boîte de dialogue Coller spécial de la bibliothèque.

hResource

Handle de modèle personnalisé.

lpSrcDataObj

Pointeur vers l’interface IDataObject de l’objet de données à coller (à partir du Presse-papiers). Ce membre est rempli lors de l’entrée. Si lpSrcDataObj a la valeur NULL lorsque OleUIPasteSpecial est appelé, OleUIPasteSpecial tente de récupérer un pointeur vers un IDataObject à partir du Presse-papiers. Si OleUIPasteSpecial réussit, il incombe à l’appelant de libérer l’objet IDataObject retourné dans lpSrcDataObj.

arrPasteEntries

Tableau OLEUIPASTEENTRY qui spécifie les formats acceptables. Ce membre est rempli lors de l’entrée.

cPasteEntries

Nombre d’entrées de tableau OLEUIPASTEENTRY . Ce membre est rempli lors de l’entrée.

arrLinkTypes

Liste des types de liens acceptables. Les types de liens sont référencés à l’aide d’OLEUIPASTEFLAG dans arrPasteEntries. Ce membre est rempli lors de l’entrée.

cLinkTypes

Nombre de types de liens. Ce membre est rempli lors de l’entrée.

cClsidExclude

Nombre de CLSID dans lpClsidExclude. Ce membre est rempli lors de l’entrée.

lpClsidExclude

Pointeur vers un tableau de CLSID à exclure de la liste des objets serveur disponibles pour une opération Paste. Notez que cela n’affecte pas coller le lien. Une application peut empêcher l’incorporation dans elle-même en répertoriant son propre CLSID dans cette liste. Ce champ est rempli lors de l’entrée.

nSelectedIndex

Index d’arrPasteEntries que l’utilisateur a sélectionné. Ce membre est rempli à la sortie.

fLink

Indique si coller ou coller le lien a été sélectionné par l’utilisateur. Ce membre est rempli à la sortie.

hMetaPict

Gérez le métafichier contenant l’icône et le titre de l’icône sélectionnés par l’utilisateur. Ce membre est rempli à la sortie.

sizel

Taille de l’objet tel qu’affiché dans sa source, si l’aspect d’affichage choisi par l’utilisateur correspond à l’aspect affiché dans la source. Si l’utilisateur choisit un autre aspect, sizel.cx et sizel.cy sont tous deux définis sur zéro. La taille de l’objet tel qu’il est affiché dans la source est récupérée à partir de ObjectDescriptor si fLink a la valeur FALSE et de LinkSrcDescriptor si fLink a la valeur TRUE. Ce membre est rempli à la sortie.

Remarques

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]
En-tête	oledlg.h

Voir aussi

OLEUIPASTEENTRY

OLEUIPASTEFLAG

OleUIPasteSpecial

Partager via