CGContext Clase

Definición

Espacio de nombres:

CoreGraphics

Ensamblado:

Xamarin.iOS.dll

Contexto de gráficos y primitivos para dibujarlos.

public class CGContext : IDisposable, ObjCRuntime.INativeObject

type CGContext = class
    interface INativeObject
    interface IDisposable

Herencia

Object

CGContext

Derivado

CoreGraphics.CGBitmapContext

CoreGraphics.CGContextPDF

Implementaciones

INativeObject IDisposable

Comentarios

Un CGContext es un destino 2D de cuarzo para dibujar. Contiene parámetros y sus estados (establecidos con funciones como M:CoreGraphics.CGContext.SetFillColor*) e información del dispositivo (por ejemplo, ConvertSizeToDeviceSpace(CGSize)). CGContexts puede representar un área de pantalla, un mapa de bits, un documento PDF o una impresora.

Hay un número limitado de CGContextdisponibles y los desarrolladores de aplicaciones deben ser conscientes de eliminarlos después de su uso. Por lo general, esto significa colocar el código de dibujo en using bloques, como se muestra en el ejemplo siguiente:

public override void Draw (RectangleF rect)
{
    base.Draw (rect);
    using (var context = UIGraphics.GetCurrentContext ())
    {
        // draw a rectangle using a path
	var myRectangleButtonPath = new CGPath ();
	myRectangleButtonPath.AddRect (new RectangleF (new PointF (100, 10), new SizeF (200, 400)));
	context.AddPath (myRectangleButtonPath);
	context.DrawPath (CGPathDrawingMode.Stroke);
    }
}          

Además, en el ejemplo se muestra el patrón muy común de un método invalidado Draw(CGRect) en un personalizado UIView y el uso de GetImageFromCurrentImageContext() para recuperar el actual CGContext en el que se va a dibujar.

Constructores

CGContext(IntPtr)

Crea un CGContext a partir de un identificador CGContextRef no administrado.

Propiedades

Handle	Identificador (puntero) a la representación del objeto no administrado.
InterpolationQuality	Sugerencia para el nivel de calidad utilizado al interpolar imágenes (por ejemplo, al escalar).
TextMatrix	Define la transformación entre el espacio de texto y el espacio de usuario. Independientemente del estado de .CGContext
TextPosition	La ubicación, en coordenadas del espacio de usuario, en la que se va a dibujar texto.

Métodos

AddArc(nfloat, nfloat, nfloat, nfloat, nfloat, Boolean)	Contexto de gráficos y primitivos para dibujarlos.
AddArcToPoint(nfloat, nfloat, nfloat, nfloat, nfloat)	Agrega un arco a la ruta de acceso actual.
AddCurveToPoint(nfloat, nfloat, nfloat, nfloat, nfloat, nfloat)	Agrega una curva Bézier cúbica en el punto actual, con los parámetros de control especificados.
AddEllipseInRect(CGRect)	Agrega una elipse que se ajusta al especificado rect.
AddLines(CGPoint[])	Agrega las líneas especificadas a la ruta de acceso actual.
AddLineToPoint(nfloat, nfloat)	Anexa una línea desde el punto actual (vea GetPathCurrentPoint()) a las coordenadas especificadas en el espacio del usuario.
AddPath(CGPath)	Agrega la ruta de acceso especificada a la ruta de acceso actual.
AddQuadCurveToPoint(nfloat, nfloat, nfloat, nfloat)	Agrega una curva Bézier cuadrática al trazado actual.
AddRect(CGRect)	Agrega una ruta rectangular a la ruta de acceso actual.
AddRects(CGRect[])	Agrega una matriz de rutas de acceso rectangulares a la ruta de acceso actual.
AsBitmapContext()	Convierte el CGContext en un CGBitmapContext.
BeginPage(Nullable<CGRect>)	Contexto de gráficos y primitivos para dibujarlos.
BeginPath()	Inicia una nueva ruta de acceso en el contexto de gráficos.
BeginTransparencyLayer(CGRect, NSDictionary)	Contexto de gráficos y primitivos para dibujarlos.
BeginTransparencyLayer(NSDictionary)	Con EndTransparencyLayer(), incluye las operaciones en una capa totalmente transparente.
ClearRect(CGRect)	Pinta el rectángulo de forma transparente.
Clip()	Establece la ruta de acceso actual del contexto de gráficos para que sea la ruta de recorte.
ClipToMask(CGRect, CGImage)	Contexto de gráficos y primitivos para dibujarlos.
ClipToRect(CGRect)	Modifica la ruta de recorte para que sea la intersección de la ruta de acceso actual y el rectángulo proporcionado.
ClipToRects(CGRect[])	Modifica la ruta de recorte actual para que sea la sección de la ruta de recorte actual y la región especificada por los rectángulos proporcionados.
ClosePath()	Cierra y completa la ruta de acceso actual.
ConcatCTM(CGAffineTransform)	Concatena el especificado transform en la matriz de transformación actual.
ContextFillRects(CGRect[])	Contexto de gráficos y primitivos para dibujarlos.
ConvertPointToUserSpace(CGPoint)	Convierte un punto de coordenadas de espacio del dispositivo en coordenadas de espacio de usuario.
ConvertRectToDeviceSpace(CGRect)	Convierte un rectángulo de coordenadas de espacio de usuario en coordenadas de espacio del dispositivo.
ConvertRectToUserSpace(CGRect)	Convierte un rectángulo de coordenadas de espacio de dispositivo en coordenadas de espacio de usuario.
ConvertSizeToDeviceSpace(CGSize)	Convierte un tamaño de coordenadas de espacio de usuario en coordenadas de espacio del dispositivo.
ConvertSizeToUserSpace(CGSize)	Convierte un tamaño de coordenadas de espacio de dispositivo en coordenadas de espacio de usuario.
CopyPath()	Devuelve una copia profunda de la ruta de acceso actual en el contexto actual.
Dispose()	Libera los recursos utilizados por el objeto CGContext.
Dispose(Boolean)	Libera los recursos utilizados por el objeto CGContext.
DrawImage(CGRect, CGImage)	Contexto de gráficos y primitivos para dibujarlos.
DrawLayer(CGLayer, CGPoint)	Dibuja una capa en el contexto de gráficos en el punto especificado.
DrawLayer(CGLayer, CGRect)	Dibuja una capa en el contexto gráfico limitado por el rectángulo especificado.
DrawLinearGradient(CGGradient, CGPoint, CGPoint, CGGradientDrawingOptions)	Contexto de gráficos y primitivos para dibujarlos.
DrawPath(CGPathDrawingMode)	Dibuja la ruta de acceso CGContextactual.
DrawPDFPage(CGPDFPage)	Representa el PDF pageespecificado.
DrawRadialGradient(CGGradient, CGPoint, nfloat, CGPoint, nfloat, CGGradientDrawingOptions)	Contexto de gráficos y primitivos para dibujarlos.
DrawShading(CGShading)	Representa el objeto especificado shading.
DrawTiledImage(CGRect, CGImage)	Contexto de gráficos y primitivos para dibujarlos.
EndPage()	Se llama para indicar el final de una página en un contexto basado en páginas.
EndTransparencyLayer()	Indica el final de una capa de transparencia.
EOClip()	Modifica la ruta de acceso de recorte actual mediante la regla Even-Odd.
EOFillPath()	Rellena la ruta de acceso actual mediante la regla Even-Odd.
FillEllipseInRect(CGRect)	Pinta la elipse definida por rect. Después, se restablece la ruta de acceso actual.
FillPath()	Rellena la ruta de acceso actual mediante una regla de desenlazamiento distinto de cero.
FillRect(CGRect)	Pinta el objeto especificado rect.
Finalize()	Finalizador para el objeto CGContext
Flush()	Obliga a representar todos los dibujos pendientes.
GetClipBoundingBox()	Cuadro de límite de la ruta de recorte actual.
GetCTM()	Recupera la matriz de transformación contexto actual.
GetPathBoundingBox()	Devuelve el rectángulo de límite de la ruta de acceso actual.
GetPathCurrentPoint()	El punto actual de la ruta de acceso CGContext.
GetUserSpaceToDeviceSpaceTransform()	CGAffineTransform que asigna coordenadas de espacio de usuario a coordenadas de espacio de dispositivo.
IsPathEmpty()	Indica si la ruta de acceso actual contiene subrutas.
MoveTo(nfloat, nfloat)	Comienza una subruta en la posición especificada.
PathContainsPoint(CGPoint, CGPathDrawingMode)	Contexto de gráficos y primitivos para dibujarlos.
PointToDeviceSpace(CGPoint)	Devuelve un nuevo PointF objeto que convierte el espacio point de usuario en el espacio del dispositivo.
ReplacePathWithStrokedPath()	Reemplaza la ruta de acceso actual por la versión trazos de la ruta de acceso, en función de los paremeters de trazo.
ResetClip()	Contexto de gráficos y primitivos para dibujarlos.
RestoreState()	Establece el estado de en CGContext lo que era cuando SaveState() se llamó por última vez.
RotateCTM(nfloat)	Gira la matriz de transformación actual por angle radianes, con valores positivos girando en sentido contrario a las agujas del reloj.
SaveState()	Almacena el estado de CGContext. (Consulte RestoreState()).
ScaleCTM(nfloat, nfloat)	Escala la matriz de transformación actual.
SelectFont(String, nfloat, CGTextEncoding)	Los desarrolladores no deben usar este método en desuso. En su lugar, los desarrolladores deben usar la API "CoreText".
SetAllowsAntialiasing(Boolean)	Si el contexto permite suavizado de contorno.
SetAllowsFontSmoothing(Boolean)	Si el contexto permite el suavizado de fuentes.
SetAllowsFontSubpixelQuantization(Boolean)	Si el contexto permite dibujar glifos en ubicaciones de subpíxeles.
SetAllowsSubpixelPositioning(Boolean)	Si el contexto permite alinear los glifos distintos de los límites de píxeles.
SetAlpha(nfloat)	Establece la opacidad del dibujo, en el intervalo 0,0 (transparente) en 1,0 (opaco).
SetBlendMode(CGBlendMode)	Especifica el modo de redacción.
SetCharacterSpacing(nfloat)	Agrega espaciado adicional entre glifos.
SetFillColor(CGColor)	Establece el color de relleno en el especificado CGColor.
SetFillColor(nfloat, nfloat)	Establece el color de relleno en un nivel gris, en el intervalo 0 (negro) en 1 (blanco).
SetFillColor(nfloat, nfloat, nfloat, nfloat)	Establece el color de relleno en los valores RGBA especificados.
SetFillColor(nfloat, nfloat, nfloat, nfloat, nfloat)	Establece el color de relleno mediante componentes de espacio de colores CMYK, además de un valor alfa.
SetFillColor(nfloat[])	Establece el color de relleno. SetFillColorSpace(CGColorSpace) se debe llamar antes.
SetFillColorSpace(CGColorSpace)	Especifica el objeto CGColorSpace que se va a usar en el contexto.
SetFillPattern(CGPattern, nfloat[])	Establece el patrón de relleno del contexto.
SetFlatness(nfloat)	Precisión de las rutas de acceso curvadas.
SetFont(CGFont)	Establece el CGFont objeto utilizado para representar texto.
SetFontSize(nfloat)	Establece el tamaño de la fuente utilizada para rende text.
SetLineCap(CGLineCap)	Establece el estilo de los extremos de las líneas.
SetLineDash(nfloat, nfloat[])	Patrón que se va a usar para dibujar líneas discontinuas.
SetLineDash(nfloat, nfloat[], Int32)	Contexto de gráficos y primitivos para dibujarlos.
SetLineJoin(CGLineJoin)	Establece la forma en que se unen las líneas.
SetLineWidth(nfloat)	Establece el ancho de la línea trazos. La línea se extiende por la mitad w hasta cualquier lado del trazado.
SetMiterLimit(nfloat)	Especifica el límite de miter para las líneas de conexión.
SetPatternPhase(CGSize)	Traduce el patrón antes de empezar a crear un mosaico.
SetRenderingIntent(CGColorRenderingIntent)	Cómo se controlan los colores fuera del espacio de colores de destino.
SetShadow(CGSize, nfloat, CGColor)	Contexto de gráficos y primitivos para dibujarlos.
SetShouldAntialias(Boolean)	Se usa junto con SetAllowsAntialiasing(Boolean) para habilitar o deshabilitar el suavizado de contorno.
SetShouldSmoothFonts(Boolean)	Se usa junto con SetAllowsFontSmoothing(Boolean) para habilitar o deshabilitar el suavizado de fuentes.
SetShouldSubpixelPositionFonts(Boolean)	Se usa junto con SetAllowsSubpixelPositioning(Boolean) para habilitar o deshabilitar la alineación del glifo con píxeles.
SetStrokeColor(CGColor)	Establece el color del trazo.
SetStrokeColor(nfloat, nfloat)	Establece el color de trazo en un valor de escala de grises.
SetStrokeColor(nfloat, nfloat, nfloat, nfloat)	Establece el color de trazo en un color RGBA.
SetStrokeColor(nfloat, nfloat, nfloat, nfloat, nfloat)	Establece el color de trazo en un color CMYKA.
SetStrokeColor(nfloat[])	Establece el color del trazo. Esta API tiene un comportamiento indefinido si no establece el espacio de colores de antemano.
SetStrokeColorSpace(CGColorSpace)	Establece el objeto CGColorSpace que se va a usar con M:CoreGraphics.CGContext.SetStrokeColor(float[])).
SetStrokePattern(CGPattern, nfloat[])	Establece el patrón de trazo del contexto.
SetTextDrawingMode(CGTextDrawingMode)	Especifica cómo se deben representar los glifos.
ShouldSubpixelQuantizeFonts(Boolean)	Con SetAllowsFontSubpixelQuantization(Boolean), determina si las fuentes se deben dibujar en ubicaciones de subpixeles.
ShowGlyphs(UInt16[])	Este método ha quedado en desuso en favor de CoreText.
ShowGlyphs(UInt16[], Int32)	Este método ha quedado en desuso en favor de CoreText.
ShowGlyphsAtPoint(nfloat, nfloat, UInt16[])	Contexto de gráficos y primitivos para dibujarlos.
ShowGlyphsAtPoint(nfloat, nfloat, UInt16[], Int32)	Contexto de gráficos y primitivos para dibujarlos.
ShowGlyphsAtPositions(UInt16[], CGPoint[], Int32)	Contexto de gráficos y primitivos para dibujarlos.
ShowGlyphsWithAdvances(UInt16[], CGSize[], Int32)	Contexto de gráficos y primitivos para dibujarlos.
ShowText(Byte[])	Este método ha quedado en desuso en favor de CoreText.
ShowText(Byte[], Int32)	Este método ha quedado en desuso en favor de CoreText.
ShowText(String)	Este método ha quedado en desuso en favor de CoreText.
ShowText(String, Int32)	Este método ha quedado en desuso en favor de CoreText.
ShowTextAtPoint(nfloat, nfloat, Byte[])	Contexto de gráficos y primitivos para dibujarlos.
ShowTextAtPoint(nfloat, nfloat, Byte[], Int32)	Contexto de gráficos y primitivos para dibujarlos.
ShowTextAtPoint(nfloat, nfloat, String)	Contexto de gráficos y primitivos para dibujarlos.
ShowTextAtPoint(nfloat, nfloat, String, Int32)	Contexto de gráficos y primitivos para dibujarlos.
StrokeEllipseInRect(CGRect)	Trazos de la elipse definida por rect. Después, se restablece la ruta de acceso actual.
StrokeLineSegments(CGPoint[])	Trazos de las líneas definidas por los pares de points. Después, se restablece la ruta de acceso actual.
StrokePath()	Trazos de la ruta de acceso actual. Después, se restablece la ruta de acceso actual.
StrokeRect(CGRect)	Trazos del objeto especificado rect. Después, se restablece la ruta de acceso actual.
StrokeRectWithWidth(CGRect, nfloat)	Trazos .rect La línea extiende la mitad de a cualquiera de width los lados del rect perímetro.
Synchronize()	Marca un CGContext para la actualización.
TranslateCTM(nfloat, nfloat)	Cambia el origen del sistema de coordenadas del usuario.

Consulte también

• avTouch
• Example_Drawing
• QuartzSample
• ZoomingPdfViewer