Clase `CDC`

Artículo
04/06/2023

Define una clase de objetos en el contexto del dispositivo.

Sintaxis

class CDC : public CObject

Miembros

Constructores públicos

Nombre	Descripción
`CDC::CDC`	Construye un objeto `CDC`.

Métodos públicos

Nombre	Descripción
`CDC::AbortDoc`	Finaliza el trabajo de impresión actual y borra todo lo que la aplicación ha escrito en el dispositivo desde la última llamada de la función miembro `StartDoc`.
`CDC::AbortPath`	Cierra y descarta los trazados del contexto de dispositivo.
`CDC::AddMetaFileComment`	Copia el comentario de un búfer en un metarchivo especificado de formato mejorado.
`CDC::AlphaBlend`	Muestra mapas de bits que tienen píxeles transparentes o semitransparentes.
`CDC::AngleArc`	Dibuja un segmento de línea y un arco, y mueve la posición actual al punto final del arco.
`CDC::Arc`	Dibuja un arco elíptico.
`CDC::ArcTo`	Dibuja un arco elíptico. Esta función es similar a `Arc`, salvo que se actualiza la posición actual.
`CDC::Attach`	Asocia un contexto de dispositivo Windows a este objeto `CDC`.
`CDC::BeginPath`	Abre un corchete de trazado en el contexto de dispositivo.
`CDC::BitBlt`	Copia un mapa de bits desde un contexto de dispositivo especificado.
`CDC::Chord`	Dibuja una cuerda (una figura cerrada delimitada por la intersección de una elipse y un segmento de línea).
`CDC::CloseFigure`	Cierra una figura abierta en un trazado.
`CDC::CreateCompatibleDC`	Crea un contexto de dispositivo de memoria que es compatible con otro contexto de dispositivo. Puede usarlo para preparar imágenes en la memoria.
`CDC::CreateDC`	Crea un contexto de dispositivo para un dispositivo específico.
`CDC::CreateIC`	Crea un contexto de información para un dispositivo específico. Esto proporciona una manera rápida de obtener información sobre el dispositivo sin necesidad de crear un contexto de dispositivo.
`CDC::DeleteDC`	Elimina el contexto de dispositivo Windows asociado a este objeto `CDC`.
`CDC::DeleteTempMap`	Llamado por el controlador de tiempo de inactividad de `CWinApp` para eliminar cualquier objeto temporal `CDC` creado por `FromHandle`. También desasocia el contexto de dispositivo.
`CDC::Detach`	Desasocia el contexto de dispositivo Windows de este objeto `CDC`.
`CDC::DPtoHIMETRIC`	Convierte las unidades de dispositivo en unidades `HIMETRIC`.
`CDC::DPtoLP`	Convierte las unidades de dispositivo en unidades lógicas.
`CDC::Draw3dRect`	Dibuja un rectángulo tridimensional.
`CDC::DrawDragRect`	Borra y vuelve a dibujar un rectángulo mientras se arrastra.
`CDC::DrawEdge`	Dibuja los bordes de un rectángulo.
`CDC::DrawEscape`	Accede a las funcionalidades de dibujo de una pantalla de vídeo que no están disponibles directamente a través de la interfaz de dispositivo gráfico (GDI).
`CDC::DrawFocusRect`	Dibuja un rectángulo con el estilo usado para indicar el foco.
`CDC::DrawFrameControl`	Dibuja un control de marco.
`CDC::DrawIcon`	Dibuja un icono.
`CDC::DrawState`	Muestra una imagen y aplica un efecto visual para indicar un estado.
`CDC::DrawText`	Dibuja texto con formato en el rectángulo especificado.
`CDC::DrawTextEx`	Dibuja texto con formato en el rectángulo especificado con otros formatos.
`CDC::Ellipse`	Dibuja una elipse.
`CDC::EndDoc`	Finaliza un trabajo de impresión iniciado por la función miembro `StartDoc`.
`CDC::EndPage`	Informa al controlador de dispositivo de que finaliza una página.
`CDC::EndPath`	Cierra un corchete de trazado y selecciona el trazado definido por el corchete en el contexto de dispositivo.
`CDC::EnumObjects`	Enumera los lápices y pinceles disponibles en un contexto de dispositivo.
`CDC::Escape`	Permite que las aplicaciones accedan a las instalaciones que no están directamente disponibles desde un dispositivo determinado a través de GDI. También permite el acceso a las funciones de escape de Windows. Las llamadas de escape que realiza una aplicación se traducen y envían al controlador del dispositivo.
`CDC::ExcludeClipRect`	Crea una zona de recorte que consta de la zona de recorte existente menos el rectángulo especificado.
`CDC::ExcludeUpdateRgn`	Impide dibujar dentro de áreas no válidas de una ventana al excluir de la zona de recorte una región actualizada de la ventana.
`CDC::ExtFloodFill`	Rellena un área con el pincel actual. Proporciona más flexibilidad que la función miembro `CDC::FloodFill`.
`CDC::ExtTextOut`	Escribe una cadena de caracteres dentro de una región rectangular mediante la fuente seleccionada actualmente.
`CDC::FillPath`	Cierra cualquier figura abierta del trazado actual y rellena el interior del trazado mediante el pincel actual y el modo de relleno de polígonos.
`CDC::FillRect`	Rellena un rectángulo determinado mediante un pincel específico.
`CDC::FillRgn`	Rellena una región específica con el pincel especificado.
`CDC::FillSolidRect`	Rellena un rectángulo con un color sólido.
`CDC::FlattenPath`	Transforma las curvas del trazado seleccionado en el contexto de dispositivo actual y convierte cada curva en una secuencia de líneas.
`CDC::FloodFill`	Rellena un área con el pincel actual.
`CDC::FrameRect`	Dibuja un borde alrededor de un rectángulo.
`CDC::FrameRgn`	Dibuja un borde alrededor de una región específica mediante un pincel.
`CDC::FromHandle`	Devuelve un puntero a un objeto `CDC` cuando se especifica un identificador de un contexto de dispositivo. Si un objeto `CDC` no está asociado al identificador, se creará y asociará un objeto `CDC` temporal.
`CDC::GetArcDirection`	Devuelve la dirección del arco actual para el contexto de dispositivo.
`CDC::GetAspectRatioFilter`	Recupera la configuración del filtro de relación de aspecto actual.
`CDC::GetBkColor`	Recupera el color de fondo actual.
`CDC::GetBkMode`	Recupera el modo de fondo.
`CDC::GetBoundsRect`	Devuelve el rectángulo delimitador acumulado actual para el contexto de dispositivo especificado.
`CDC::GetBrushOrg`	Recupera el origen del pincel actual.
`CDC::GetCharABCWidths`	Recupera los anchos, en unidades lógicas, de caracteres consecutivos en un intervalo determinado de la fuente actual.
`CDC::GetCharABCWidthsI`	Recupera los anchos, en unidades lógicas, de índices de glifo consecutivos en un intervalo especificado de la fuente TrueType actual.
`CDC::GetCharacterPlacement`	Recupera varios tipos de información sobre una cadena de caracteres.
`CDC::GetCharWidth`	Recupera los anchos fraccionarios de caracteres consecutivos en un intervalo determinado de la fuente actual.
`CDC::GetCharWidthI`	Recupera los anchos, en coordenadas lógicas, de índices de glifo consecutivos en un intervalo especificado de la fuente actual.
`CDC::GetClipBox`	Recupera las dimensiones del rectángulo delimitador más estrecho alrededor del límite de recorte actual.
`CDC::GetColorAdjustment`	Recupera los valores de ajuste de color para el contexto de dispositivo.
`CDC::GetCurrentBitmap`	Devuelve un puntero al objeto `CBitmap` seleccionado actualmente.
`CDC::GetCurrentBrush`	Devuelve un puntero al objeto `CBrush` seleccionado actualmente.
`CDC::GetCurrentFont`	Devuelve un puntero al objeto `CFont` seleccionado actualmente.
`CDC::GetCurrentPalette`	Devuelve un puntero al objeto `CPalette` seleccionado actualmente.
`CDC::GetCurrentPen`	Devuelve un puntero al objeto `CPen` seleccionado actualmente.
`CDC::GetCurrentPosition`	Recupera la posición actual del lápiz (en coordenadas lógicas).
`CDC::GetDCBrushColor`	Recupera el color de pincel actual.
`CDC::GetDCPenColor`	Recupera el color del lápiz actual.
`CDC::GetDeviceCaps`	Recupera un tipo especificado de información concreta del dispositivo sobre las funcionalidades de un dispositivo de visualización determinado.
`CDC::GetFontData`	Recupera información de métricas de fuente de un archivo de fuente escalable. Para identificar qué información se va a recuperar, se especifica un desplazamiento en el archivo de fuente y la longitud de la información que se devolverá.
`CDC::GetFontLanguageInfo`	Devuelve información sobre la fuente seleccionada actualmente para el contexto de visualización especificado.
`CDC::GetGlyphOutline`	Recupera la curva de contorno o el mapa de bits de un carácter de contorno en la fuente actual.
`CDC::GetGraphicsMode`	Recupera el modo gráfico actual para el contexto de dispositivo especificado.
`CDC::GetHalftoneBrush`	Recupera un pincel de semitonos.
`CDC::GetKerningPairs`	Recupera los pares de interletraje de caracteres para la fuente seleccionada actualmente en el contexto de dispositivo especificado.
`CDC::GetLayout`	Recupera el diseño de un contexto de dispositivo (DC). El diseño puede ser de izquierda a derecha (valor predeterminado) o de derecha a izquierda (reflejado).
`CDC::GetMapMode`	Recupera el modo de asignación actual.
`CDC::GetMiterLimit`	Devuelve el límite angular para el contexto de dispositivo.
`CDC::GetNearestColor`	Recupera el color lógico más cercano a un color lógico especificado que el dispositivo determinado puede representar.
`CDC::GetOutlineTextMetrics`	Recupera información de métricas de fuente para fuentes TrueType.
`CDC::GetOutputCharWidth`	Recupera los anchos de caracteres individuales de un grupo consecutivo de caracteres de la fuente actual mediante el contexto de dispositivo de salida.
`CDC::GetOutputTabbedTextExtent`	Calcula el ancho y el alto de una cadena de caracteres en el contexto de dispositivo de salida.
`CDC::GetOutputTextExtent`	Calcula el ancho y el alto de una línea de texto en el contexto de dispositivo de salida mediante la fuente actual para determinar las dimensiones.
`CDC::GetOutputTextMetrics`	Recupera las métricas de la fuente actual del contexto de dispositivo de salida.
`CDC::GetPath`	Recupera las coordenadas que definen los extremos de líneas y los puntos de control de curvas que se encuentran en el trazado seleccionado en el contexto de dispositivo.
`CDC::GetPixel`	Recupera el valor de color RGB del píxel en el punto especificado.
`CDC::GetPolyFillMode`	Recupera el modo actual de relleno de polígonos.
`CDC::GetROP2`	Recupera el modo de dibujo actual.
`CDC::GetSafeHdc`	Devuelve `CDC::m_hDC`, el contexto de dispositivo de salida.
`CDC::GetStretchBltMode`	Recupera el modo de extensión del mapa de bits actual.
`CDC::GetTabbedTextExtent`	Calcula el ancho y el alto de una cadena de caracteres en el contexto de dispositivo de atributo.
`CDC::GetTextAlign`	Recupera las marcas de alineación de texto.
`CDC::GetTextCharacterExtra`	Recupera la configuración actual de la cantidad de espaciado entre caracteres.
`CDC::GetTextColor`	Recupera el color actual del texto.
`CDC::GetTextExtent`	Calcula el ancho y el alto de una línea de texto en el contexto de dispositivo de atributo mediante la fuente actual para determinar las dimensiones.
`CDC::GetTextExtentExPointI`	Recupera el número de caracteres de una cadena especificada que cabrá en un espacio determinado y rellena una matriz con la extensión de texto para cada uno de esos caracteres.
`CDC::GetTextExtentPointI`	Recupera el ancho y el alto de la matriz especificada de índices de glifo.
`CDC::GetTextFace`	Copia el nombre del tipo de letra de la fuente actual en un búfer como una cadena terminada en null.
`CDC::GetTextMetrics`	Recupera las métricas de la fuente actual del contexto de dispositivo de atributo.
`CDC::GetViewportExt`	Recupera las extensiones x e y del área de visualización.
`CDC::GetViewportOrg`	Recupera las coordenadas x e y del origen del área de visualización.
`CDC::GetWindow`	Devuelve la ventana asociada al contexto de dispositivo de visualización.
`CDC::GetWindowExt`	Recupera las extensiones x e y de la ventana asociada.
`CDC::GetWindowOrg`	Recupera las coordenadas x e y del origen de la ventana asociada.
`CDC::GetWorldTransform`	Recupera la transformación actual del espacio global al espacio de página.
`CDC::GradientFill`	Rellena las estructuras de rectángulo y triángulo con un color que se degrada.
`CDC::GrayString`	Dibuja texto atenuado en la ubicación especificada.
`CDC::HIMETRICtoDP`	Convierte las unidades HIMETRIC en unidades de dispositivo.
`CDC::HIMETRICtoLP`	Convierte las unidades HIMETRIC en unidades lógicas.
`CDC::IntersectClipRect`	Crea una zona de recorte al formar la intersección de la región actual y un rectángulo.
`CDC::InvertRect`	Invierte el contenido de un rectángulo.
`CDC::InvertRgn`	Invierte los colores de una región.
`CDC::IsPrinting`	Determina si el contexto de dispositivo se usa para imprimir.
`CDC::LineTo`	Dibuja una línea desde la posición actual hasta un punto (no incluido).
`CDC::LPtoDP`	Convierte las unidades lógicas en unidades de dispositivo.
`CDC::LPtoHIMETRIC`	Convierte las unidades lógicas en unidades HIMETRIC.
`CDC::MaskBlt`	Combina los datos de color de los mapas de bits de origen y destino mediante la operación de máscara y trama especificadas.
`CDC::ModifyWorldTransform`	Cambia la transformación global de un contexto de dispositivo mediante el modo especificado.
`CDC::MoveTo`	Mueve la posición actual.
`CDC::OffsetClipRgn`	Mueve la zona de recorte del dispositivo especificado.
`CDC::OffsetViewportOrg`	Modifica el origen del área de visualización en relación con las coordenadas del origen del área de visualización actual.
`CDC::OffsetWindowOrg`	Modifica el origen de la ventana en relación con las coordenadas del origen de la ventana actual.
`CDC::PaintRgn`	Rellena una región con el pincel seleccionado.
`CDC::PatBlt`	Crea un patrón de bits.
`CDC::Pie`	Dibuja una cuña con forma circular.
`CDC::PlayMetaFile`	Reproduce el contenido del metarchivo especificado en el dispositivo determinado. La versión mejorada de `PlayMetaFile` muestra la imagen almacenada en el metarchivo de formato mejorado. El metarchivo se puede reproducir cualquier número de veces.
`CDC::PlgBlt`	Realiza una transferencia de bloques de bits de los bits de datos de color desde el rectángulo especificado en el contexto de dispositivo de origen hasta el paralelogramo especificado en el contexto de dispositivo determinado.
`CDC::PolyBezier`	Dibuja una o varias B-splines. La posición actual no se usa ni actualiza.
`CDC::PolyBezierTo`	Dibuja una o varias B-splines y mueve la posición actual al punto final de la última B-spline.
`CDC::PolyDraw`	Dibuja un conjunto de segmentos de línea y B-splines. Esta función actualiza la posición actual.
`CDC::Polygon`	Dibuja un polígono que consta de dos o más puntos (vértices) conectados por líneas.
`CDC::Polyline`	Dibuja un conjunto de segmentos de línea que conectan los puntos especificados.
`CDC::PolylineTo`	Dibuja una o varias líneas rectas y mueve la posición actual al punto final de la última línea.
`CDC::PolyPolygon`	Crea dos o más polígonos que se rellenan mediante el modo de relleno de polígono actual. Los polígonos pueden estar separados o superponerse.
`CDC::PolyPolyline`	Dibuja varias series de segmentos de línea conectados. Esta función no usa ni actualiza la posición actual.
`CDC::PtVisible`	Especifica si el punto determinado está dentro de la zona de recorte.
`CDC::RealizePalette`	Asigna entradas de la paleta lógica actual a la paleta del sistema.
`CDC::Rectangle`	Dibuja un rectángulo con el lápiz actual y lo rellena con el pincel actual.
`CDC::RectVisible`	Determina si alguna parte del rectángulo especificado se encuentra dentro de la zona de recorte.
`CDC::ReleaseAttribDC`	Libera `m_hAttribDC`, el contexto de dispositivo de atributo.
`CDC::ReleaseOutputDC`	Libera `m_hDC`, el contexto de dispositivo de salida.
`CDC::ResetDC`	Actualiza el contexto de dispositivo de `m_hAttribDC`.
`CDC::RestoreDC`	Restaura el contexto de dispositivo a un estado anterior guardado con `SaveDC`.
`CDC::RoundRect`	Dibuja un rectángulo con las esquinas redondeadas con el lápiz actual y rellenado con el pincel actual.
`CDC::SaveDC`	Guarda el estado actual del contexto de dispositivo.
`CDC::ScaleViewportExt`	Modifica la extensión del área de visualización en relación con los valores actuales.
`CDC::ScaleWindowExt`	Modifica las extensiones de la ventana en relación con los valores actuales.
`CDC::ScrollDC`	Desplaza un rectángulo de bits horizontal y verticalmente.
`CDC::SelectClipPath`	Selecciona el trazado actual como zona de recorte para el contexto de dispositivo, y combina la nueva región con cualquier zona de recorte existente mediante el modo especificado.
`CDC::SelectClipRgn`	Combina la región especificada con la zona de recorte actual mediante el modo especificado.
`CDC::SelectObject`	Selecciona un objeto de dibujo GDI, como un lápiz.
`CDC::SelectPalette`	Selecciona la paleta lógica.
`CDC::SelectStockObject`	Selecciona uno de los lápices, pinceles o fuentes predefinidos que proporciona Windows.
`CDC::SetAbortProc`	Establece una función de devolución de llamada proporcionada por el programador a la que Windows llama si se debe anular un trabajo de impresión.
`CDC::SetArcDirection`	Establece la dirección de dibujo que se va a usar para las funciones de arco y rectángulo.
`CDC::SetAttribDC`	Establece `m_hAttribDC`, el contexto de dispositivo de atributo.
`CDC::SetBkColor`	Establece el color de fondo actual.
`CDC::SetBkMode`	Establece el modo de fondo.
`CDC::SetBoundsRect`	Controla la acumulación de información del rectángulo delimitador para el contexto de dispositivo especificado.
`CDC::SetBrushOrg`	Especifica el origen del siguiente pincel seleccionado en un contexto de dispositivo.
`CDC::SetColorAdjustment`	Establece los valores de ajuste de color para el contexto de dispositivo mediante los valores especificados.
`CDC::SetDCBrushColor`	Establece el color del pincel actual.
`CDC::SetDCPenColor`	Establece el color del lápiz actual.
`CDC::SetGraphicsMode`	Establece el modo gráfico actual para el contexto de dispositivo especificado.
`CDC::SetLayout`	Cambia el diseño de un contexto de dispositivo (DC).
`CDC::SetMapMode`	Establece el modo de asignación actual.
`CDC::SetMapperFlags`	Modifica el algoritmo que el asignador de fuentes usa cuando asigna fuentes lógicas a fuentes físicas.
`CDC::SetMiterLimit`	Establece el límite de la longitud de las uniones angulares para el contexto de dispositivo.
`CDC::SetOutputDC`	Establece `m_hDC`, el contexto de dispositivo de salida.
`CDC::SetPixel`	Establece el píxel del punto especificado en la aproximación más cercana al color especificado.
`CDC::SetPixelV`	Establece el píxel de las coordenadas especificadas en la aproximación más cercana al color especificado. `SetPixelV` es más rápido que `SetPixel` porque no es necesario devolver el valor de color del punto pintado.
`CDC::SetPolyFillMode`	Establece el modo de relleno de polígono.
`CDC::SetROP2`	Establece el modo de dibujo actual.
`CDC::SetStretchBltMode`	Establece el modo de extensión de mapa de bits.
`CDC::SetTextAlign`	Establece las marcas de alineación de texto.
`CDC::SetTextCharacterExtra`	Establece la cantidad de espaciado entre caracteres.
`CDC::SetTextColor`	Establece el color del texto.
`CDC::SetTextJustification`	Agrega espacio a los caracteres de salto de una cadena.
`CDC::SetViewportExt`	Establece las extensiones x e y del área de visualización.
`CDC::SetViewportOrg`	Establece el origen del área de visualización.
`CDC::SetWindowExt`	Establece las extensiones x e y de la ventana asociada.
`CDC::SetWindowOrg`	Establece el origen de la ventana del contexto de dispositivo.
`CDC::SetWorldTransform`	Establece la transformación actual del espacio global al espacio de página.
`CDC::StartDoc`	Informa al controlador de dispositivo de que se está iniciando un nuevo trabajo de impresión.
`CDC::StartPage`	Informa al controlador de dispositivo de que se está iniciando una página nueva.
`CDC::StretchBlt`	Mueve un mapa de bits desde un rectángulo y dispositivo de origen hasta un rectángulo de destino, para lo que se extiende o se comprime el mapa de bits si es necesario para que se ajuste a las dimensiones del rectángulo de destino.
`CDC::StrokeAndFillPath`	Cierra cualquier figura abierta de un trazado, traza el contorno del trazado con el lápiz actual y rellena su interior con el pincel actual.
`CDC::StrokePath`	Representa el trazado especificado con el lápiz actual.
`CDC::TabbedTextOut`	Escribe una cadena de caracteres en una ubicación especificada, para lo que expande las tabulaciones a los valores especificados en una matriz de posiciones de tabulación.
`CDC::TextOut`	Escribe una cadena de caracteres en una ubicación especificada con la fuente seleccionada actualmente.
`CDC::TransparentBlt`	Transfiere un bloque de bits de datos de color desde el contexto de dispositivo de origen especificado hasta un contexto de dispositivo de destino, y hace transparente un color especificado en la transferencia.
`CDC::UpdateColors`	Actualiza el área cliente del contexto de dispositivo, para lo que hace coincidir los colores actuales del área cliente con la paleta del sistema píxel a píxel.
`CDC::WidenPath`	Redefine el trazado actual como el área que se pintaría si dicho trazado se trazase con el lápiz seleccionado actualmente en el contexto de dispositivo.

Operadores públicos

Nombre	Descripción
`CDC::operator HDC`	Recupera el identificador del contexto de dispositivo.

Miembros de datos públicos

Nombre	Descripción
`CDC::m_hAttribDC`	Contexto de dispositivo de atributo usado por este objeto `CDC`.
`CDC::m_hDC`	Contexto de dispositivo de salida usado por este objeto `CDC`.

Comentarios

El CDC objeto proporciona funciones miembro para trabajar con un contexto de dispositivo, como una pantalla o impresora, y los miembros para trabajar con un contexto de visualización asociado al área cliente de una ventana.

Realice todo el dibujo mediante las funciones miembro de un objeto CDC. La clase proporciona funciones miembro para las operaciones de contexto de dispositivo, el trabajo con herramientas de dibujo, la selección de objetos de interfaz de dispositivo gráfico (GDI) con seguridad de tipos y el trabajo con colores y paletas. También proporciona funciones miembro para obtener y establecer atributos de dibujo, realizar asignaciones, trabajar con el área de visualización, trabajar con la extensión de la ventana, convertir coordenadas, trabajar con regiones, recortar, dibujar líneas, y dibujar formas simples, elipses y polígonos. También se proporcionan funciones miembro para dibujar texto, trabajar con fuentes, usar escapes de impresora, desplazarse y reproducir metarchivos.

Para usar un objeto CDC, constrúyalo y llame a sus funciones miembro que ejecutan en paralelo funciones de Windows que usan contextos de dispositivo.

Nota:

En Windows 95/98, todas las coordenadas de pantalla están limitadas a 16 bits. Por lo tanto, un objeto int pasado a una función miembro CDC debe estar en el intervalo de -32768 a 32767.

La biblioteca MCF (Microsoft Foundation Class) proporciona varias clases derivadas de CDC para usos específicos. CPaintDC encapsula las llamadas a BeginPaint y EndPaint. CClientDC administra un contexto de visualización asociado al área cliente de una ventana. CWindowDC administra un contexto de visualización asociado a una ventana completa, incluidos su marco y controles. CMetaFileDC asocia un contexto de dispositivo a un metarchivo.

CDC proporciona dos funciones miembro y GetLayoutSetLayout, para revertir el diseño de un contexto de dispositivo, que no hereda su diseño de una ventana. Esta orientación de derecha a izquierda es necesaria para las aplicaciones escritas para las referencias culturales, como árabe o hebreo, donde el diseño de caracteres no es el estándar europeo.

CDC contiene dos contextos de dispositivo, m_hDC y m_hAttribDC, que, cuando se crea un objeto CDC, hacen referencia al mismo dispositivo. CDC dirige todas las llamadas de GDI de salida a m_hDC y la mayoría de las llamadas de GDI de atributo a m_hAttribDC. (Un ejemplo de una llamada de atributo es GetTextColor, mientras que SetTextColor es una llamada de salida).

Por ejemplo, el marco usa estos dos contextos de dispositivo para implementar un objeto CMetaFileDC que enviará la salida a un metarchivo mientras lee los atributos de un dispositivo físico. La vista previa de impresión se implementa en el marco de forma similar. También puede usar los dos contextos de dispositivo de forma similar en el código específico de la aplicación.

A veces podría necesitar información de métricas de texto de los contextos de dispositivo m_hDC y m_hAttribDC. Los siguientes pares de funciones proporcionan esta funcionalidad:

Usa m_hAttribDC	Usa m_hDC
`GetTextExtent`	`GetOutputTextExtent`
`GetTabbedTextExtent`	`GetOutputTabbedTextExtent`
`GetTextMetrics`	`GetOutputTextMetrics`
`GetCharWidth`	`GetOutputCharWidth`

Para obtener más información sobre CDC, consulte Contextos de dispositivo.

Jerarquía de herencia

CObject

CDC

Requisitos

Encabezadoafxwin.h:

`CDC::AbortDoc`

Finaliza el trabajo de impresión actual y borra todo lo que la aplicación ha escrito en el dispositivo desde la última llamada a la función miembro StartDoc.

int AbortDoc();

Valor devuelto

Un valor mayor o igual que 0 si se realiza correctamente, o un valor negativo si se ha producido un error. En la lista siguiente se muestran los valores de error comunes y sus significados:

SP_ERROR: error general.
SP_OUTOFDISK: no hay suficiente espacio en disco disponible actualmente para la cola y no habrá más espacio disponible.
SP_OUTOFMEMORY: no hay suficiente memoria disponible para la cola.
SP_USERABORT: el usuario finalizó el trabajo con el Administrador de impresión.

Comentarios

Esta función miembro reemplaza el escape de impresora ABORTDOC.

Debe usarse AbortDoc para finalizar lo siguiente:

Operaciones de impresión que no especifican una función abort mediante SetAbortProc.
Operaciones de impresión que aún no han alcanzado su primera llamada de escape NEWFRAME o NEXTBAND.

Si una aplicación encuentra un error de impresión o una operación de impresión cancelada, no debe intentar finalizar la operación mediante las funciones miembro EndDoc o AbortDoc de la clase CDC. GDI finaliza automáticamente la operación antes de devolver el valor de error.

Si la aplicación muestra un cuadro de diálogo para permitir al usuario cancelar la operación de impresión, debe llamar a AbortDoc antes de destruir el cuadro de diálogo.

Si se usó el Administrador de impresión para iniciar el trabajo de impresión, al llamar se AbortDoc borra todo el trabajo de cola, la impresora no recibe nada. Si el Administrador de impresión no se usó para iniciar el trabajo de impresión, es posible que los datos se hayan enviado a la impresora antes AbortDoc de llamarse. En este caso, el controlador de impresora habría restablecido la impresora (en caso de que fuera posible) y cerrado el trabajo de impresión.

Ejemplo

Vea el ejemplo de CDC::StartDoc.

`CDC::AbortPath`

Cierra y descarta los trazados del contexto de dispositivo.

BOOL AbortPath();

Valor devuelto

Es distinto de cero si la función se realiza correctamente; de lo contrario, es 0.

Comentarios

Si hay un corchete de ruta de acceso abierto en el contexto del dispositivo, se cierra el corchete de ruta de acceso y se descarta la ruta de acceso. Si hay una ruta de acceso cerrada en el contexto del dispositivo, se descarta la ruta de acceso.

`CDC::AddMetaFileComment`

Copia el comentario de un búfer en un metarchivo especificado de formato mejorado.

BOOL AddMetaFileComment(
    UINT nDataSize,
    const BYTE* pCommentData);

Parámetros

nDataSize
Especifica la longitud del búfer de comentarios en bytes.

pCommentData
Apunta al búfer que contiene el comentario.

Valor devuelto

Es distinto de cero si la función se realiza correctamente; de lo contrario, es 0.

Comentarios

Un comentario puede incluir cualquier información privada, por ejemplo, el origen de la imagen y la fecha en que se creó. Un comentario debe comenzar con una firma de aplicación, seguida de los datos. Los comentarios no deben contener datos específicos de la posición. Los datos específicos de la posición especifican la ubicación de un registro y no se deben incluir porque un metarchivo se puede incrustar dentro de otro metarchivo. Esta función solo se puede usar con metarchivos mejorados.

`CDC::AlphaBlend`

Llame a esta función miembro para mostrar mapas de bits que tienen píxeles transparentes o semitransparentes.

BOOL AlphaBlend(
    int xDest,
    int yDest,
    int nDestWidth,
    int nDestHeight,
    CDC* pSrcDC,
    int xSrc,
    int ySrc,
    int nSrcWidth,
    int nSrcHeight,
    BLENDFUNCTION blend);

Parámetros

xDest
Especifica la coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

yDest
Especifica la coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de destino.

nDestWidth
Especifica el ancho, en unidades lógicas, del rectángulo de destino.

nDestHeight
Especifica el alto, en unidades lógicas, del rectángulo de destino.

pSrcDC
Puntero al contexto de dispositivo de origen.

xSrc
Especifica la coordenada x, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.

ySrc
Especifica la coordenada y, en unidades lógicas, de la esquina superior izquierda del rectángulo de origen.

nSrcWidth
Especifica el ancho, en unidades lógicas, del rectángulo de origen.

nSrcHeight
Especifica el alto, en unidades lógicas, del rectángulo de origen.

blend
Especifica una estructura BLENDFUNCTION.

Valor devuelto

TRUE si es correcto; de lo contrario, FALSE.

Comentarios

Para obtener más información, consulte el método AlphaBlend en Windows SDK.

`CDC::AngleArc`

Dibuja un segmento de línea y un arco.

BOOL AngleArc(
    int x,
    int y,
    int nRadius,
    float fStartAngle,
    float fSweepAngle);

Parámetros

x
Especifica la coordenada x lógica del centro del círculo.

y
Especifica la coordenada y lógica del centro del círculo.

nRadius
Especifica el radio del círculo en unidades lógicas. Este valor debe ser positivo.

fStartAngle
Especifica el ángulo inicial en grados en relación con el eje x.

fSweepAngle
Especifica el ángulo de barrido en grados en relación con el ángulo inicial.

Valor devuelto

Si es correcta, su valor es distinto de cero. En caso contrario, es cero.

Comentarios

El segmento de línea se dibuja desde la posición actual hasta el principio del arco. El arco se dibuja a lo largo del perímetro de un círculo con el radio y el centro especificados. La longitud del arco se define mediante los ángulos inicial y de barrido especificados.

AngleArc mueve la posición actual al punto final del arco. El arco dibujado por esta función puede parecer elíptico, según el modo de transformación y asignación actual. Antes de dibujar el arco, esta función dibuja el segmento de línea desde la posición actual hasta el principio del arco. Para dibujar el arco, se construye un círculo imaginario con el radio especificado alrededor del punto central especificado. Para determinar el punto inicial del arco, se mide el número de grados del ángulo inicial en sentido contrario a las agujas del reloj desde el eje x del círculo. El punto final se determina de forma similar; para ello, se mide el número de grados del ángulo de barrido en sentido contrario a las agujas del reloj desde el punto inicial.

Si el ángulo de barrido tiene más de 360 grados, el arco realiza un barrido varias veces. Esta función dibuja líneas con el lápiz actual. La figura no se rellena.

`CDC::Arc`

Dibuja un arco elíptico.

BOOL Arc(
    int x1,
    int y1,
    int x2,
    int y2,
    int x3,
    int y3,
    int x4,
    int y4);

BOOL Arc(
    LPCRECT lpRect,
    POINT ptStart,
    POINT ptEnd);

Parámetros

x1
Especifica la coordenada x de la esquina superior izquierda del rectángulo delimitador (en unidades lógicas).

y1
Especifica la coordenada y de la esquina superior izquierda del rectángulo delimitador (en unidades lógicas).

x2
Especifica la coordenada x de la esquina inferior derecha del rectángulo delimitador (en unidades lógicas).

y2
Especifica la coordenada y de la esquina inferior derecha del rectángulo delimitador (en unidades lógicas).

x3
Especifica la coordenada x del punto que define el punto inicial del arco (en unidades lógicas). Este punto no tiene que estar exactamente en el arco.

y3
Especifica la coordenada y del punto que define el punto inicial del arco (en unidades lógicas). Este punto no tiene que estar exactamente en el arco.

x4
Especifica la coordenada x del punto que define el punto final del arco (en unidades lógicas). Este punto no tiene que estar exactamente en el arco.

y4
Especifica la coordenada y del punto que define el punto final del arco (en unidades lógicas). Este punto no tiene que estar exactamente en el arco.

lpRect
Especifica el rectángulo delimitador (en unidades lógicas). Puede pasar un objeto LPRECT o CRect para este parámetro.

ptStart
Especifica las coordenadas x e y del punto que define el punto inicial del arco (en unidades lógicas). Este punto no tiene que estar exactamente en el arco. Puede pasar una POINT estructura o un CPoint objeto para este parámetro.

ptEnd
Especifica las coordenadas x e y del punto que define el punto final del arco (en unidades lógicas). Este punto no tiene que estar exactamente en el arco. Puede pasar una POINT estructura o un CPoint objeto para este parámetro.

Valor devuelto

Es distinto de cero si la función se realiza correctamente; de lo contrario, es 0.

Comentarios

El arco dibujado mediante la función es un segmento de la elipse definido por el rectángulo delimitador especificado.

El punto inicial real del arco es el punto en el que un radio dibujado desde el centro del rectángulo delimitador y que pasa por el punto inicial especificado forma una intersección con la elipse. El punto final real del arco es el punto en el que un radio dibujado desde el centro del rectángulo delimitador y que pasa por el punto final especificado forma una intersección con la elipse. El arco se dibuja en sentido contrario a las agujas del reloj. Dado que un arco no es una figura cerrada, no se rellena. Tanto el ancho como el alto del rectángulo deben tener más de 2 unidades y menos de 32 767.

Ejemplo

void CDCView::DrawArc(CDC *pDC)
{
   // Fill the client area with a thin circle. The circle's
   // interior is not filled. The circle's perimeter is
   // blue from 6 o'clock to 3 o'clock and red from 3
   // o'clock to 6 o'clock.

   // Get the client area.
   CRect rectClient;
   GetClientRect(rectClient);

   // Make a couple of pens.
   CPen penBlue;
   CPen penRed;
   CPen *pOldPen;

   penBlue.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(0, 0, 255));
   penRed.CreatePen(PS_SOLID | PS_COSMETIC, 1, RGB(255, 0, 0));

   // Draw from 3 o'clock to 6 o'clock, counterclockwise,
   // in a blue pen.

   pOldPen = pDC->SelectObject(&penBlue);

   pDC->Arc(rectClient,
            CPoint(rectClient.right, rectClient.CenterPoint().y),
            CPoint(rectClient.CenterPoint().x, rectClient.right));

   // Draw from 6 o'clock to 3 o'clock, counterclockwise,
   // in a red pen.
   pDC->SelectObject(&penRed);

   // Keep the same parameters, but reverse start
   // and end points.
   pDC->Arc(rectClient,
            CPoint(rectClient.CenterPoint().x, rectClient.right),
            CPoint(rectClient.right, rectClient.CenterPoint().y));

   // Restore the previous pen.
   pDC->SelectObject(pOldPen);
}

`CDC::ArcTo`

Dibuja un arco elíptico.

BOOL ArcTo(
    int x1,
    int y1,
    int x2,
    int y2,
    int x3,
    int y3,
    int x4,
    int y4);

BOOL ArcTo(
    LPCRECT lpRect,
    POINT ptStart,
    POINT ptEnd);