Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
La structure FORMATETC est un format de presse-papiers généralisé, amélioré pour englober un dispositif cible, un aspect ou une vue des données et un support de stockage. Un consommateur de données, tel qu’une application conteneur OLE, transmet la structure FORMATETC en tant qu’argument dans les appels à IDataObject pour indiquer le type de données qu’il souhaite à partir d’une source de données, comme un objet de document composé. La source utilise la structure FORMATETC pour décrire les formats qu’il peut fournir.
FORMATETC peut décrire pratiquement toutes les données, y compris d’autres objets tels que des monikers. Un conteneur peut demander à l’un de ses objets incorporés de répertorier ses formats de données en appelant IDataObject ::EnumFormatEtc, qui retourne un objet énumérateur qui implémente l’interface IEnumFORMATETC . Au lieu de répondre simplement à « texte et bitmap », l’objet peut fournir une description détaillée des données, y compris l’appareil (normalement écran ou imprimante) pour lequel il est affiché, l’aspect à présenter à l’utilisateur (contenu complet, miniature, icône ou formaté pour l’impression) et le support de stockage contenant les données (mémoire globale, mémoire globale, fichier disque, objet de stockage ou flux). Cette capacité à décrire étroitement les données entraîne, dans le temps, une sortie d’imprimante et d’écran de meilleure qualité, ainsi qu’une efficacité accrue dans la navigation des données, où un croquis miniature est beaucoup plus rapide à récupérer et à afficher qu’un rendu entièrement détaillé.
Le tableau suivant répertorie les champs de la structure de données FORMATETC et les informations qu’ils spécifient.
| Terrain | Spécifie |
|---|---|
|
cfFormat |
Format dans lequel les données doivent être présentées, qui peut être un format Presse-papiers standard, un format propriétaire ou un format OLE. Pour plus d’informations sur les formats OLE, consultez Documents composés. |
|
Ptd |
Structure DVTARGETDEVICE, qui contient suffisamment d’informations sur un appareil cible Windows, comme un écran ou une imprimante, pour qu’un handle vers son contexte de périphérique (hDC) puisse être créé à l’aide de la fonction CreateDC. |
|
dwAspect |
Aspect ou vue des données à afficher ; peut être le contenu complet, un croquis miniatures, une icône ou mis en forme pour l’impression. |
|
lindex |
La partie de l’aspect qui est intéressant. La valeur la plus courante est -1, indiquant que la vue entière est intéressante. L’index de base zéro doit être utilisé pour CFSTR_FILECONTENTS format. |
|
tymed |
Le support de stockage des données, qui peut être une mémoire globale, un fichier disque ou une instance de l’une des interfaces de stockage structurées de COM. |