CMetaFileDC::CreateEnhanced
Crea un contexto para un metarchivo de ampliar- formato.
BOOL CreateEnhanced(
CDC* pDCRef,
LPCTSTR lpszFileName,
LPCRECT lpBounds,
LPCTSTR lpszDescription
);
Parámetros
pDCRef
Identifica un dispositivo de referencia para el metarchivo mejorado.lpszFileName
Señala una cadena de caracteres terminada en null.Especifica el nombre de archivo para que el metarchivo mejorado se crea.Si este parámetro es NULL, el metarchivo mejorado se almacena en la memoria y su contenido derrochar cuando se destruye el objeto o cuando se llama a la función de Win32 DeleteEnhMetaFile .lpBounds
Señala una estructura de datos de RECT o un objeto de CRect que especifica las dimensiones en unidades de HIMETRIC (en incrementos de .01 milímetro) de la imagen que se almacene en el metarchivo mejorado.lpszDescription
Señala una cadena cero- cancelada que especifica el nombre de la aplicación que creó la imagen, así como el título de la imagen.
Valor devuelto
Un identificador de contexto para el metarchivo mejorado, si correctamente; si no NULL.
Comentarios
Este DC se puede utilizar para almacenar una imagen independientes del dispositivo.
Windows utiliza el dispositivo de referencia identificado por el parámetro de pDCRef para registrar la resolución y unidades de dispositivo en el que una imagen produjo originalmente.Si el parámetro de pDCRef es NULL, utiliza el dispositivo de presentación actual para la referencia.
Los miembros de la izquierda y de la parte superior de la estructura de datos de RECT indicada por el parámetro de lpBounds deben ser menores que los miembros de la derecha e inferior, respectivamente.Los puntos a lo largo de los bordes del rectángulo se incluyen en la imagen.Si lpBounds es NULL, la interfaz de dispositivo gráfico (GDI) calcula las dimensiones del rectángulo más pequeño que puede agregar imágenes dibujado por la aplicación.El parámetro de lpBounds se debe proporcionar en lo posible.
La cadena indicada por el parámetro de lpszDescription debe contener un carácter null entre el nombre de aplicación y el nombre de la imagen y debe terminar con dos caracteres null (por ejemplo, “el editor de gráficos de XYZ \ 0Bald Eagle \ 0 \ 0”, donde \ 0 representa el carácter null.Si lpszDescription es NULL, no hay ninguna entrada correspondiente en el encabezado de metarchivo mejorado.
Las aplicaciones utilizan DC creado por esta función para almacenar una imagen de gráficos en un metarchivo mejorado.El identificador que identifica este DC puede pasarse a cualquier función de GDI.
Después de que una aplicación almacene una imagen en un metarchivo mejorado, puede mostrar la imagen en cualquier dispositivo de salida llamando a la función de CDC::PlayMetaFile .Al mostrar la imagen, Windows utiliza el rectángulo designado por el parámetro de lpBounds y los datos de la resolución del dispositivo de la referencia para colocar y escalar la imagen.El contexto de dispositivo devuelto por esta función contiene los mismos atributos predeterminados asociados a cualquier nuevo DC.
Las aplicaciones deben utilizar la función de Win32 GetWinMetaFileBits para convertir un metarchivo mejorado el formato anterior de metarchivo de Windows.
El nombre de archivo para el metarchivo mejorado debe utilizar la extensión de .EMF.
Requisitos
encabezado: afxext.h