Funzione CreateEnhMetaFileA (wingdi.h)

La funzione CreateEnhMetaFile crea un contesto di dispositivo per un metafile in formato avanzato. Questo contesto di dispositivo può essere usato per archiviare un'immagine indipendente dal dispositivo.

Sintassi

HDC CreateEnhMetaFileA(
  [in] HDC        hdc,
  [in] LPCSTR     lpFilename,
  [in] const RECT *lprc,
  [in] LPCSTR     lpDesc
);

Parametri

[in] hdc

Handle per un dispositivo di riferimento per il metafile avanzato. Questo parametro può essere NULL; per altre informazioni, vedere Osservazioni.

[in] lpFilename

Puntatore al nome del file per il metafile avanzato da creare. Se questo parametro è NULL, il metafile avanzato è basato sulla memoria e il relativo contenuto viene perso quando viene eliminato tramite la funzione DeleteEnhMetaFile .

[in] lprc

Puntatore a una struttura RECT che specifica le dimensioni (in unità di 01 millimetri) dell'immagine da archiviare nel metafile avanzato.

[in] lpDesc

Puntatore a una stringa che specifica il nome dell'applicazione che ha creato l'immagine, nonché il titolo dell'immagine. Questo parametro può essere NULL; per altre informazioni, vedere Osservazioni.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per il contesto di dispositivo per il metafile avanzato.

Se la funzione ha esito negativo, il valore restituito è NULL.

Commenti

Dove gli argomenti di testo devono usare caratteri Unicode, usare la funzione CreateEnhMetaFile come funzione a caratteri wide. Dove gli argomenti di testo devono usare caratteri del set di caratteri di Windows, usare questa funzione come funzione ANSI.

Il sistema usa il dispositivo di riferimento identificato dal parametro hdcRef per registrare la risoluzione e le unità del dispositivo in cui è stata originariamente visualizzata un'immagine. Se il parametro hdcRef è NULL, usa il dispositivo di visualizzazione corrente per riferimento.

I membri sinistro e superiore della struttura RECT a cui punta il parametro lpRect devono essere rispettivamente minori dei membri destro e inferiore . I punti lungo i bordi del rettangolo sono inclusi nell'immagine. Se lpRect è NULL, l'interfaccia GDI (Graphics Device Interface) calcola le dimensioni del rettangolo più piccolo che circonda l'immagine disegnata dall'applicazione. Il parametro lpRect deve essere specificato laddove possibile.

La stringa a cui punta il parametro lpDescription deve contenere un carattere Null tra il nome dell'applicazione e il nome dell'immagine e deve terminare con due caratteri Null, ad esempio "XYZ Graphics Editor\0Bald Eagle\0\0", dove \0 rappresenta il carattere Null. Se lpDescription è NULL, non esiste alcuna voce corrispondente nell'intestazione enhanced-metafile.

Le applicazioni usano il contesto di dispositivo creato da questa funzione per archiviare un'immagine grafica in un metafile avanzato. L'handle che identifica questo contesto di dispositivo può essere passato a qualsiasi funzione GDI.

Dopo che un'applicazione archivia un'immagine in un metafile avanzato, può visualizzare l'immagine in qualsiasi dispositivo di output chiamando la funzione PlayEnhMetaFile . Quando si visualizza l'immagine, il sistema usa il rettangolo a cui punta il parametro lpRect e i dati di risoluzione dal dispositivo di riferimento per posizionare e ridimensionare l'immagine.

Il contesto di dispositivo restituito da questa funzione contiene gli stessi attributi predefiniti associati a qualsiasi nuovo contesto di dispositivo.

Le applicazioni devono usare la funzione GetWinMetaFileBits per convertire un metafile avanzato nel formato precedente del metafile di Windows.

Il nome del file per il metafile avanzato deve usare l'estensione .emf.

Esempio

Per un esempio, vedere Creazione di un metafile avanzato.

Requisiti

Vedi anche

CloseEnhMetaFile

DeleteEnhMetaFile

GetEnhMetaFileDescription

GetEnhMetaFileHeader

GetWinMetaFileBits

Funzioni metafile

Panoramica dei metafile

PlayEnhMetaFile

RECT