Structure FORMATETC (objidl.h)

Représente un format de Presse-papiers généralisé. Il est amélioré pour englober un appareil cible, l’aspect ou la vue des données et un indicateur de support de stockage. Où l’on peut s’attendre à trouver un format presse-papiers, OLE utilise plutôt une structure de données FORMATETC . Cette structure est utilisée comme paramètre dans les fonctions et méthodes OLE qui nécessitent des informations de format de données.

Syntaxe

typedef struct tagFORMATETC {
  CLIPFORMAT     cfFormat;
  DVTARGETDEVICE *ptd;
  DWORD          dwAspect;
  LONG           lindex;
  DWORD          tymed;
} FORMATETC, *LPFORMATETC;

Members

cfFormat

Format du Presse-papiers intéressant. Il existe trois types de formats reconnus par OLE :

• Formats d’échange standard, tels que CF_TEXT.
• Les formats d’application privée compris uniquement par l’application offrant le format ou par d’autres applications offrant des fonctionnalités similaires.
• Formats OLE, utilisés pour créer des objets liés ou incorporés.

ptd

Pointeur vers une structure DVTARGETDEVICE contenant des informations sur l’appareil cible pour lequel les données sont composées. Une valeur NULL est utilisée chaque fois que le format de données spécifié est indépendant de l’appareil cible ou lorsque l’appelant ne s’occupe pas de l’appareil utilisé. Dans ce dernier cas, si les données nécessitent un appareil cible, l’objet doit choisir un appareil par défaut approprié (souvent l’affichage pour les composants visuels). Les données obtenues à partir d’un objet avec un appareil cible NULL , comme la plupart des métafichiers, sont indépendantes de l’appareil cible. Les données résultantes sont généralement les mêmes que si l’utilisateur a choisi la commande Enregistrer sous dans le menu Fichier et sélectionné un format d’échange.

dwAspect

Indique la quantité de détails à contenir dans le rendu. Ce paramètre doit être l’une des valeurs d’énumération DVASPECT . Un format de Presse-papiers unique peut prendre en charge plusieurs aspects ou vues de l’objet. La plupart des méthodes de transfert de données et de présentation et de mise en cache transmettent des informations d’aspect. Par exemple, un appelant peut demander l’image emblématique d’un objet à l’aide du format du Presse-papiers métafichier pour le récupérer. Notez qu’une seule valeur DVASPECT peut être utilisée dans dwAspect. Autrement dit, dwAspect ne peut pas être le résultat d’une opération OR booléenne sur plusieurs valeurs DVASPECT .

lindex

Partie de l’aspect lorsque les données doivent être divisées entre les limites de page. La valeur la plus courante est -1, qui identifie toutes les données. L’index de base zéro doit être utilisé pour CFSTR_FILECONTENTS format. Pour les aspects DVASPECT_THUMBNAIL et DVASPECT_ICON, lindex est ignoré.

tymed

Une des constantes d’énumération TYMED qui indiquent le type de support de stockage utilisé pour transférer les données de l’objet. Les données peuvent être transférées à l’aide de n’importe quel support logique pour l’objet. Par exemple, les données peuvent être transmises à l’aide de la mémoire globale, d’un fichier de disque ou d’objets de stockage structuré. Pour plus d’informations, consultez l’énumération TYMED .

Remarques

La structure FORMATETC est utilisée par des méthodes dans les interfaces de transfert de données et de présentation en tant que paramètre spécifiant les données transférées. Par exemple, la méthode IDataObject ::GetData utilise la structure FORMATETC pour indiquer exactement quel type de données l’appelant demande.

Spécifications

Voir aussi

DVASPECT

IDataAdviseHolder

IDataObject

IEnumFORMATETC

IOleCache

OleCreate

OleCreateFromData

OleCreateLink

OleCreateLinkFromData

OleCreateLinkToFile

OleCreateStaticFromData

STATDATA

STGMEDIUM

TYMED