dcgraph.h

Clase wxGCDC

wxGCDC es un contexto de dispositivo que dibuja sobre un wxGraphicsContext.

Jerarquía:

Jerarquía de la clase wxGCDC

wxGCDC hace todo lo posible para implementar la API de wxDC, pero las siguientes características no están (completamente) implementadas porque wxGraphicsContext no las soporta:

  • El método GetPixel() no está implementado y siempre devuelve false porque las capas gráficas modernas no soportan la recuperación del contenido de los píxeles dibujados.
  • El método FloodFill() no está, ni puede estar, implementado, ya que su funcionalidad depende también de la lectura de los píxeles de wxGraphicsContext.
  • El método SetLogicalFunction() sólo funciona con las funciones wxCOPY, wxOR, wxNO_OP, wxCLEAR y wxXOR, los intentos de utilizar cualquier otra función (incluyendo wxINVERT) no hacen nada.
  • Del mismo modo, el parámetro wxRasterOperationMode de Blit() y StretchBlit() sólo puede ser una de las funciones lógicas soportadas enumeradas anteriormente, si se utiliza cualquier otra función se producirá un fallo de aserción y no se dibujará nada.
  • Para wxGraphicsContext basado en Direct2D, sólo se pueden utilizar fuentes true-type en las funciones relacionadas con fuentes.

Funciones miembro

wxGCDC()

wxGCDC::wxGCDC(const wxWindowDC & windowDC)

Construye un wxGCDC a partir de un wxWindowDC.

wxGCDC()

wxGCDC::wxGCDC(const wxMemoryDC & memoryDC)

Construye un wxGCDC a partir de un wxMemoryDC.

wxGCDC()

wxGCDC::wxGCDC(const wxPrinterDC & printerDC)

Construye un wxGCDC a partir de un wxPrinterDC.

wxGCDC()

wxGCDC::wxGCDC(wxGraphicsContext * context)

Construye un wxGCDC a partir de un contexto gráfico existente.

Nótese que este objeto toma posesión del contexto y lo borrará cuando sea destruido o cuando se llame a SetGraphicsContext() con un objeto de contexto diferente.

Obsérvese también que el contexto continuará utilizando la misma fuente, pluma y pincel que antes hasta que se llame explícitamente a SetFont(), SetPen() o SetBrush() para cambiarlos. Esto significa que el código puede utilizar este objeto derivado de wxDC para trabajar con plumas y pinceles con componente alfa, por ejemplo (que normalmente no está soportado por la API de wxDC), pero también significa que los valores de retorno de GetFont(), GetPen() y GetBrush() no se corresponderán realmente con los objetos realmente utilizados porque simplemente no pueden representarlos de ninguna manera. Si se desea evitar tal discrepancia, se necesita llamar a los métodos setter para sincronizar la fuente, pluma y pincel de wxDC y wxGraphicsContext.

wxGCDC()

wxGCDC::wxGCDC(const wxEnhMetaFileDC & emfDC)

Construye un wxGCDC a partir de un wxEnhMetaFileDC.

Este constructor sólo está disponible en el port wxMSW y cuando la opción de construcción wxUSE_ENH_METAFILE está activada, es decir, cuando la propia clase wxEnhMetaFileDC está disponible.

wxGCDC()

wxGCDC::wxGCDC()

Constructor por defecto.

~wxGCDC()

virtual wxGCDC::~wxGCDC()

Destructor.

GetGraphicsContext()

wxGraphicsContext* wxGCDC::GetGraphicsContext() const

Recupera el wxGraphicsContext asociado.

Reimplementado de wxDC.

SetGraphicsContext()

void wxGCDC::SetGraphicsContext(wxGraphicsContext * context)

Establece el contexto gráfico que se utilizará para este wxGCDC.

Hay que tener en cuenta que este objeto toma la propiedad del contexto y lo borrará cuando sea destruido o cuando SetGraphicsContext() sea llamado de nuevo.

Además, a diferencia del constructor que toma wxGraphicsContext, este método volverá a aplicar la fuente, la pluma y el pincel actuales, de forma que este objeto siga utilizándolos, si habían sido cambiados anteriormente (lo que nunca ocurre cuando se construye wxGCDC directamente desde wxGraphicsContext).

Reimplementado de wxDC.

Métodos y datos heredados

Esta clase hereda los métodos y datos miembro públicos y protegidos de wxDC y wxObject.