Struttura FORMATETC (objidl.h)

Articolo
08/25/2023

Rappresenta un formato generalizzato degli Appunti. È migliorato per includere un dispositivo di destinazione, l'aspetto o la visualizzazione dei dati e un indicatore medio di archiviazione. In caso di attesa di trovare un formato appunti, OLE usa invece una struttura di dati FORMATETC . Questa struttura viene usata come parametro nelle funzioni e nei metodi OLE che richiedono informazioni sul formato dei dati.

Sintassi

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

Members

cfFormat

Formato degli Appunti di interesse. Esistono tre tipi di formati riconosciuti da OLE:

Formati di interscambio standard, ad esempio CF_TEXT.
I formati delle applicazioni private sono compresi solo dall'applicazione che offre il formato o da altre applicazioni che offrono funzionalità simili.
Formati OLE, usati per creare oggetti collegati o incorporati.

ptd

Puntatore a una struttura DVTARGETDEVICE contenente informazioni sul dispositivo di destinazione per cui vengono composti i dati. Un valore NULL viene usato ogni volta che il formato di dati specificato è indipendente dal dispositivo di destinazione o quando il chiamante non è interessato a quale dispositivo viene usato. In quest'ultimo caso, se i dati richiedono un dispositivo di destinazione, l'oggetto deve scegliere un dispositivo predefinito appropriato (spesso la visualizzazione per i componenti visivi). I dati ottenuti da un oggetto con un dispositivo di destinazione NULL , ad esempio la maggior parte dei metafile, sono indipendenti dal dispositivo di destinazione. I dati risultanti sono in genere uguali a se l'utente sceglie il comando Salva con nome dal menu File e seleziona un formato di interscambio.

dwAspect

Indica la quantità di dettaglio che deve essere contenuta nel rendering. Questo parametro deve essere uno dei valori di enumerazione DVASPECT . Un singolo formato appunti può supportare più aspetti o visualizzazioni dell'oggetto. La maggior parte dei dati e il trasferimento della presentazione e i metodi di memorizzazione nella cache passano le informazioni sugli aspetti. Ad esempio, un chiamante potrebbe richiedere un'immagine iconica di un oggetto, usando il formato degli Appunti metafile per recuperarlo. Si noti che è possibile usare un solo valore DVASPECT in dwAspect. Ovvero, dwAspect non può essere il risultato di un'operazione OR booleana su diversi valori DVASPECT .

lindex

Parte dell'aspetto quando i dati devono essere suddivisi tra limiti di pagina. Il valore più comune è -1, che identifica tutti i dati. Per gli aspetti DVASPECT_THUMBNAIL e DVASPECT_ICON, lindex viene ignorato.

tymed

Una delle costanti di enumerazione TYMED che indicano il tipo di supporto di archiviazione usato per trasferire i dati dell'oggetto. I dati possono essere trasferiti usando qualsiasi mezzo ha senso per l'oggetto. Ad esempio, i dati possono essere passati usando memoria globale, un file di disco o oggetti di archiviazione strutturati. Per altre informazioni, vedere l'enumerazione TYMED .

Commenti

La struttura FORMATETC viene usata dai metodi nelle interfacce di trasferimento e presentazione dei dati come parametro che specificano i dati trasferiti. Ad esempio, il metodo IDataObject::GetData usa la struttura FORMATETC per indicare esattamente il tipo di dati richiesto dal chiamante.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop \| App UWP]
Server minimo supportato	Windows 2000 Server [app desktop \| App UWP]
Intestazione	objidl.h