Structure OLEUIPASTEENTRYA (oledlg.h)

Article
11/20/2024

Tableau d’entrées à spécifier dans la structure OLEUIPASTESPECIAL de la boîte de dialogue coller spécial. Chaque entrée inclut une structure FORMATETC qui spécifie les formats acceptables, une chaîne qui représente le format dans la zone de liste de la boîte de dialogue, une chaîne pour personnaliser le texte de résultat de la boîte de dialogue et un ensemble d’indicateurs de l’énumération OLEUIPASTEFLAG. Les indicateurs indiquent si l’entrée est valide pour coller uniquement, lier uniquement ou coller et lier. Si l’entrée est valide pour la liaison, les indicateurs indiquent quels types de liens sont acceptables par OR’ing les valeurs appropriées OLEUIPASTE_LINKTYPEn.

Syntaxe

typedef struct tagOLEUIPASTEENTRYA {
  FORMATETC fmtetc;
  LPCSTR    lpstrFormatName;
  LPCSTR    lpstrResultText;
  DWORD     dwFlags;
  DWORD     dwScratchSpace;
} OLEUIPASTEENTRYA, *POLEUIPASTEENTRYA, *LPOLEUIPASTEENTRYA;

Membres

fmtetc

Format acceptable. La boîte de dialogue Coller un spécial vérifie si ce format est proposé par l’objet dans le Presse-papiers et, le cas échéant, l’offre à l’utilisateur.

lpstrFormatName

Pointeur vers la chaîne qui représente le format vers l’utilisateur. Toute %s de cette chaîne est remplacée par fullUserTypeName de l’objet dans le Presse-papiers et la chaîne résultante est placée dans la zone de liste de la boîte de dialogue. Une seule %s est autorisée. La présence ou l’absence de %s spécifie si le texte du résultat est d’indiquer que les données sont collées ou qu’un objet pouvant être activé par une application est collé. Si %s est présent, le texte résultant indique qu’un objet est collé. Sinon, il indique que les données sont collées.

lpstrResultText

Pointeur vers la chaîne utilisée pour personnaliser le texte résultant de la boîte de dialogue lorsque l’utilisateur sélectionne le format correspondant à cette entrée. Toute %s de cette chaîne est remplacée par le nom de l’application ou FullUserTypeName de l’objet dans le Presse-papiers. Une seule %s est autorisée.

dwFlags

Valeurs de énumération OLEUIPASTEFLAG.

dwScratchSpace

Espace de travail disponible pour les routines qui parcourent une IEnumFORMATETC pour marquer si le format PasteEntry est disponible. Ce champ peut être laissé non initialisé.

Remarques

Note

L’en-tête oledlg.h définit OLEUIPASTEENTRY 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

OLEUIPASTEFLAG

OLEUIPASTESPECIAL

OleUIPasteSpecial

Partager via