Structure OLEUIPASTESPECIALA (oledlg.h)
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 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 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 |
|---|---|
|
La boîte de dialogue affiche un bouton Aide . |
|
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. |
|
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. |
|
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. |
|
La zone De case activée Icône d’affichage est désactivée lors de l’initialisation. |
|
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 . |
|
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. |
|
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
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour