COleDataSource::CacheData

Article
03/04/2013

Appelez cette fonction pour spécifier un format dans lequel les données sont offertes pendant les opérations de transfert de données.

void CacheData(
   CLIPFORMAT cfFormat,
   LPSTGMEDIUM lpStgMedium,
   LPFORMATETC lpFormatEtc = NULL 
);

Paramètres

cfFormat
Le format de presse-papiers dans lequel les données doivent être offertes.Ce paramètre peut être un des formats de presse-papiers prédéfinis ou de la valeur retourné par la fonction native de RegisterClipboardFormat windows.
lpStgMedium
Les points à STGMEDIUM structure contenant les données au format spécifié.
lpFormatEtc
Pointe vers une structure de FORMATETC décrivant le format dans lequel les données doivent être offertes.Indiquez une valeur pour ce paramètre si vous souhaitez spécifier des informations de mise en forme supplémentaires au delà de le format de presse-papiers spécifié par cfFormat.Si c'est NULL, les valeurs par défaut sont utilisées pour les autres champs dans la structure de FORMATETC .

Notes

Vous devez fournir les données, car cette fonction contribue à l'aide de le rendu immédiat.Les données sont mises en cache jusqu'à ce que nécessaire.

Fournissez des données à l'aide d'une structure de STGMEDIUM .Vous pouvez également utiliser la fonction membre d' CacheGlobalData si la quantité de données que vous fournissez est suffisamment petit pour être transférée efficacement à l'aide de HGLOBAL.

Après l'appel à CacheData le membre de ptd d' lpFormatEtc et le contenu d' lpStgMedium soient appartenant à l'objet de données, pas par l'appelant.

Pour utiliser le rendu différé, appelez la fonction membre de DelayRenderData ou de DelayRenderFileData .Pour plus d'informations sur le rendu différée comme géré par les MFC, consultez l'article objets de données et sources de données : manipulation.

Pour plus d'informations, consultez les structures de STGMEDIUM et de FORMATETC dans Kit de développement logiciel Windows*.*

Pour plus d'informations, consultez RegisterClipboardFormat dans Kit de développement logiciel Windows.