STRUCTURE OLEUIPASTESPECIALA (oledlg.h)

Article
11/20/2024

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

Syntaxe

typedef struct tagOLEUIPASTESPECIALA {
  DWORD              cbStruct;
  DWORD              dwFlags;
  HWND               hWndOwner;
  LPCSTR             lpszCaption;
  LPFNOLEUIHOOK      lpfnHook;
  LPARAM             lCustData;
  HINSTANCE          hInstance;
  LPCSTR             lpszTemplate;
  HRSRC              hResource;
  LPDATAOBJECT       lpSrcDataObj;
  LPOLEUIPASTEENTRYA arrPasteEntries;
  int                cPasteEntries;
  UINT               *arrLinkTypes;
  int                cLinkTypes;
  UINT               cClsidExclude;
  LPCLSID            lpClsidExclude;
  int                nSelectedIndex;
  BOOL               fLink;
  HGLOBAL            hMetaPict;
  SIZEL              sizel;
} OLEUIPASTESPECIALA, *POLEUIPASTESPECIALA, *LPOLEUIPASTESPECIALA;

Membres

cbStruct

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

dwFlags

Lors de l’entrée, dwFlags spécifie les indicateurs d’initialisation et de création. À 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 sera 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 sur l’arrêt de boîte de dialogue. Indicateur IN/OUT.
PSF_SELECTPASTELINK	La case d’option PasteLink sera sélectionnée au démarrage de la boîte de dialogue. Spécifie également l’état du bouton sur l’arrêt de boîte de dialogue. Indicateur IN/OUT.
PSF_CHECKDISPLAYASICON	Indique si l’icône afficher sous case d’option a été cochée lors de l’arrêt de la boîte de dialogue. Indicateur OUT.
PSF_DISABLEDISPLAYASICON	La case à cocher Afficher en tant qu’icône 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. Consultez STAYONCLIPBOARDCHANGE sinon.
STAYONCLIPBOARDCHANGE	Utilisé pour indiquer à la boîte de dialogue de rester à jour si le Presse-papiers change pendant que la boîte de dialogue est en cours. 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, ce qui supprime la boîte de dialogue, car les options qu’il propose à l’utilisateur ne sont plus up-to-date 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 pendant que la boîte de dialogue est en cours 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 coller spéciale sur une 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 propriétaire de la boîte de dialogue. Ce membre ne doit pas être NULL.

lpszCaption

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

lpfnHook

Pointeur vers une fonction de raccordement qui traite les messages destinés à la boîte de dialogue. La fonction de raccordement doit retourner zéro pour transmettre un message qu’elle n’a pas réappuché à la procédure de boîte de dialogue dans la bibliothèque. La fonction de 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 de 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 du modèle de boîte de dialogue à remplacer par le modèle de boîte de dialogue Coller un modèle de boîte de dialogue 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 est 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 le 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 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 Coller. Notez que cela n’affecte pas coller le lien. Une application peut empêcher l’incorporation en elle-même en listant son propre CLSID dans cette liste. Ce champ est rempli lors de l’entrée.

nSelectedIndex

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

fLink

Que Coller ou Coller le lien a été sélectionné par l’utilisateur. Ce membre est rempli sur 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 sur la sortie.

sizel

Taille de l’objet tel qu’il est 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 aspect différent, 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 l’ObjectDescriptor si fLink est FALSE et à partir de LinkSrcDescriptor si fLink est TRUE. Ce membre est rempli sur la sortie.

Remarques

Note

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. Le mélange 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
d’en-tête	oledlg.h

Voir aussi

OLEUIPASTEENTRY

OLEUIPASTEFLAG

OleUIPasteSpecial

Partager via