void CacheData ( CLIPFORMAT cfFormat, LPSTGMEDIUM lpStgMedium, LPFORMATETC lpFormatEtc = NULL );
Paramètres
cfFormat
Le format de presse-papiers dans lequel les données sont offertes. Ce paramètre peut être un des formats prédéfinis presse-papiers ou la valeur retournée par la native Windows fonction RegisterClipboardFormat.
lpStgMedium
Points à un structure STGMEDIUM contenant les données dans le format spécifié.
lpFormatEtc
Points à un structure FORMATETC décrivant le format dans lequel les données sont offertes. Fournir une valeur pour ce paramètre si vous souhaitez spécifier des informations sur le format supplémentaire au-delà de la format de presse-papiers spécifié par cfFormat. Si elle est NULL, les valeurs par défaut sont utilisées pour les autres champs dans la structure FORMATETC.
Remarques
Appelez cette fonction pour spécifier un format dans lequel des données sont offert lors de données opérations de transfert. Vous devez fournir les données, car cette fonction il fournit à l'aide de rendu immédiat. Les données mises en cache jusqu'à ce que nécessaire.
Four&nir les données en utilisant un structure STGMEDIUM . Vous pouvez également utiliser la fonction membre CacheGlobalData si la quantité de données que vous fournissez est assez petite pour être transférées efficacement à l'aide d'un .nbsp HGLOBAL;
Après l'appel à CacheData le ptd membre de lpFormatEtc et le contenu de lpStgMedium sont la propriété de l'objet de données, non par l'appelant.
Pour utiliser le rendu du retard, appelez la fonction membre DelayRenderData ou DelayRenderFileData . Pour plus d'informations sur le rendu différé comme géré par MFC, consultez l'article objets de données et Sources de données : Manipulation dans le Guide du programmeur Visual C++.
Pour plus d'informations, consultez la STGMEDIUM et les structures FORMATETC dans la OLE 2 de référence du programmeur, Volume 1.
Pour plus d'informations, voir RegisterClipboardFormat dans la documentation Win32.
Aperçu COleDataSource | ; Membres de la classe | Graphique de la hiérarchie
Voir aussi ;COleDataSource::CacheGlobalData, COleDataSource::DelayRenderData, COleDataSource::DelayRenderFileData, COleDataSource::SetClipboard, COleDataSource::DoDragDrop