CMetaFileDC::CreateEnhanced

BOOL CreateEnhanced ( CDC * pDCRef, LPCTSTR lpszFileName, LPCRECT lpBounds, LPCTSTR lpszDescription );

Valor devuelto

Un identificador del contexto de dispositivo para el metarchivo mejorado, si tiene éxito; caso contrario NULL.

Parámetros

pDCRef

Identifica un dispositivo de referencia para el metarchivo mejorado.

lpszFileName

Puntos para una cadena de caracteres terminada en null. Especifica el nombre del metarchivo mejorado a crearse. Si este parámetro es NULL, el metarchivo mejorado es la memoria base y su contenido perdido cuando se destruye el objeto o la :: DeleteEnhMetaFile se llama función.

lpBounds

Apunta a una estructura de datos RECT o un objeto CRect que especifica las dimensiones en unidades HIMETRIC (en incrementos de.01 milímetros) de la imagen que debe almacenarse en el metarchivo mejorado.

lpszDescription

Puntos a una cadena terminada en cero que especifica el nombre de la aplicación que creó la imagen, así como también el título de la imagen.

Observaciones

Crea un contexto de dispositivo de un metarchivo mejorado formato. Este DC puede utilizarse para almacenar una imagen independiente del dispositivo.

Windows utiliza el dispositivo de referencia identificado por el parámetro pDCRef para registrar las unidades del dispositivo en el que originalmente apareció una imagen y resolución. Si el parámetro pDCRef es NULL, utiliza el dispositivo de visualización actual de referencia.

Los miembros izquierdos y superiores de la estructura de datos RECT apuntado por el parámetro lpBounds deben ser menores que los miembros de derecho e inferior, respectivamente. En la imagen se incluyen puntos a lo largo de los bordes del rectángulo. Si lpBounds es NULL, la interfaz de dispositivo gráfico (GDI) calcula las dimensiones del rectángulo más pequeño que puede encerrar la imagen dibujada por la aplicación. El parámetro lpBounds debe suministrarse cuando sea posible.

La cadena apuntada por el parámetro lpszDescription debe contener un carácter nulo entre el nombre de la aplicación y el nombre de la imagen y debe terminar con dos caracteres null — por ejemplo, "XYZ Graphics Editor\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 la DC creado por esta función para almacenar una imagen de gráficos en un metarchivo mejorado. El identificador de identificar este DC puede pasar a cualquier función GDI.

Después de una aplicación almacena una imagen en un metarchivo mejorado, puede mostrar la imagen en cualquier dispositivo de salida llamando a la función CDC::PlayMetaFile . Al mostrar la imagen, Windows utiliza el rectángulo al que apunta el parámetro lpBounds y los datos de resolución desde el dispositivo de referencia de posición y escalar la imagen. El contexto de dispositivo devuelto por esta función contiene los mismos atributos por defecto asociados a cualquier nuevo DC.

Las aplicaciones deben utilizar la :: GetWinMetaFileBits función para convertir un metarchivo mejorado en el antiguo formato de metarchivo de Windows.

Debe utilizar el nombre de archivo para el metarchivo mejorado el.Extensión EMF.

Visió&n General de CMetaFileDC |nbsp; Miembros de clase | Diagrama de jerarquía

See Also   CMetaFileDC::CloseEnhanced, CDC::PlayMetaFile, ::CloseEnhMetaFile, ::DeleteEnhMetaFile, ::GetEnhMetaFileDescription, ::GetEnhMetaFileHeader, ::GetWinMetaFileBits, ::PlayEnhMetaFile

Index