CMetaFileDC::CreateEnhanced
Crea un contesto di dispositivo per un metafile di avanzato- formato.
BOOL CreateEnhanced(
CDC* pDCRef,
LPCTSTR lpszFileName,
LPCRECT lpBounds,
LPCTSTR lpszDescription
);
Parametri
pDCRef
Identifica un dispositivo di riferimento di l Enhanced Metafile.lpszFileName
Punta a una stringa di caratteri con terminazione null.Specifica il nome file di l Enhanced Metafile da creare.Se questo parametro è NULL, in Enhanced Metafile è residente in memoria e i relativi contenuti hanno perso quando l'oggetto viene eliminato oppure quando la funzione Win32 DeleteEnhMetaFile è denominata.lpBounds
Punta a una struttura di dati RECT o a un oggetto CRect che specifica le dimensioni in unità HIMETRIC (in incrementi di .01 millimetri) dell'immagine da archiviare in Enhanced Metafile.lpszDescription
Punta a una stringa che termina con zero che specifica il nome dell'applicazione che ha creato l'immagine e il titolo dell'immagine.
Valore restituito
L'handle del contesto di dispositivo per il Enhanced Metafile, in caso di esito positivo; in caso contrario NULL.
Note
Questo controller di dominio può essere utilizzato per archiviare un'immagine indipendente dal dispositivo.
Windows utilizza il dispositivo di riferimento identificato dal parametro pDCRef per registrare la risoluzione e le unità di dispositivo in cui l'immagine originale è presente.Se il parametro pDCRef è NULL, utilizza lo schermo corrente per riferimento.
I membri sinistra e superiore della struttura dei dati RECT indicata dal parametro lpBounds devono essere più piccoli i membri del basso e a destra, rispettivamente.I punti lungo i bordi del rettangolo vengono inclusi nell'immagine.Se lpBounds è NULL, i Graphics Device Interface (GDI) calcola le dimensioni di più piccolo rettangolo che può includere l'immagine tracciata dall'applicazione.Il parametro lpBounds deve essere fornito in possibile.
La stringa indicata dal parametro lpszDescription deve contenere un carattere null tra il nome dell'applicazione e il nome dell'immagine e deve terminare con due caratteri null, ad esempio "l'editor grafico \ 0Bald Eagle \ 0 \ 0 di XYZ", dove \ 0 rappresenta il carattere null.Se lpszDescription è NULL, non esiste alcuna voce corrispondente nell'intestazione di Enhanced Metafile.
Le applicazioni utilizzano il controller di dominio creato dalla funzione per archiviare immagine di grafica in un Enhanced Metafile.Handle che identificano il controller di dominio possono essere passate a qualsiasi funzione GDI.
Dopo che un'applicazione memorizzati un'immagine in un Enhanced Metafile, può visualizzare l'immagine in qualsiasi dispositivo di output chiamando la funzione CDC::PlayMetaFile.Quando si visualizzano l'immagine, Windows utilizza il rettangolo puntato dal parametro lpBounds e ai dati di risoluzione del dispositivo di riferimento per posizionare e ridimensionare l'immagine.Il contesto di dispositivo restituito dalla funzione contiene gli stessi attributi predefiniti associati al nuovo controller di dominio.
Le applicazioni devono utilizzare la funzione Win32 GetWinMetaFileBits per convertire un Enhanced Metafile nel formato precedente metafile Windows.
Il nome file di l Enhanced Metafile deve utilizzare l'estensione di .EMF.
Requisiti
Header: afxext.h