CGContext Classe

Referência

Definição

Namespace:: CoreGraphics

Assembly:: Xamarin.iOS.dll

Assembly:: Xamarin.Mac.dll

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Contexto gráfico e primitivos a serem desenhados neles.

public class CGContext : IDisposable, ObjCRuntime.INativeObject

type CGContext = class
    interface INativeObject
    interface IDisposable

Herança: Object
CGContext

Derivado: CoreGraphics.CGBitmapContext

CoreGraphics.CGContextPDF

Implementações: INativeObject IDisposable

Comentários

Um CGContext é um destino 2D do Quartz para desenho. Ele contém parâmetros e seus estados (definidos com funções como M:CoreGraphics.CGContext.SetFillColor*) e informações do dispositivo (por exemplo, ConvertSizeToDeviceSpace(CGSize)). CGContexts podem representar uma área de tela, um bitmap, um documento PDF ou uma impressora.

Há um número limitado de CGContexts disponíveis e os desenvolvedores de aplicativos devem ser conscientes sobre o descarte deles após o uso. Em geral, isso significa colocar o código de desenho em using blocos, conforme mostrado no exemplo a seguir:

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);
    }
}

Além disso, o exemplo mostra o padrão muito comum de um método substituído Draw(CGRect) em um personalizado UIView e o uso de GetImageFromCurrentImageContext() para recuperar o atual CGContext no qual desenhar.

Construtores

CGContext(IntPtr)

Cria um CGContext de um identificador CGContextRef não gerenciado.

Propriedades

Handle	Manipule (ponteiro) para a representação de objeto não gerenciado.
InterpolationQuality	Uma dica para o nível de qualidade usado ao interpolar imagens (por exemplo, ao dimensionar).
TextMatrix	Define a transformação entre o espaço de texto e o espaço do usuário. Independente do CGContextestado do .
TextPosition	O local, nas coordenadas de espaço do usuário, no qual desenhar texto.

Métodos

AddArc(nfloat, nfloat, nfloat, nfloat, nfloat, Boolean)	Contexto gráfico e primitivos a serem desenhados neles.
AddArcToPoint(nfloat, nfloat, nfloat, nfloat, nfloat)	Adiciona um arco ao caminho atual.
AddCurveToPoint(nfloat, nfloat, nfloat, nfloat, nfloat, nfloat)	Adiciona uma curva Bézier cúbica ao ponto atual, com os parâmetros de controle especificados.
AddEllipseInRect(CGRect)	Adiciona uma elipse que se encaixa no especificado `rect`.
AddLines(CGPoint[])	Adiciona as linhas fornecidas ao caminho atual.
AddLineToPoint(nfloat, nfloat)	Acrescenta uma linha do ponto atual (consulte GetPathCurrentPoint()) às coordenadas especificadas no espaço do usuário.
AddPath(CGPath)	Adiciona o caminho especificado ao caminho atual.
AddQuadCurveToPoint(nfloat, nfloat, nfloat, nfloat)	Adiciona uma curva quadrática de Bézier ao caminho atual.
AddRect(CGRect)	Adiciona um caminho retangular ao caminho atual.
AddRects(CGRect[])	Adiciona uma matriz de caminhos retangulares ao caminho atual.
AsBitmapContext()	Converte o CGContext em um CGBitmapContext.
BeginPage(Nullable<CGRect>)	Contexto gráfico e primitivos a serem desenhados neles.
BeginPath()	Inicia um novo caminho no contexto gráfico.
BeginTransparencyLayer(CGRect, NSDictionary)	Contexto gráfico e primitivos a serem desenhados neles.
BeginTransparencyLayer(NSDictionary)	Com EndTransparencyLayer(), coloca as operações em uma camada totalmente transparente.
ClearRect(CGRect)	Pinta o retângulo de forma transparente.
Clip()	Define o caminho atual do contexto gráfico como o caminho de recorte.
ClipToMask(CGRect, CGImage)	Contexto gráfico e primitivos a serem desenhados neles.
ClipToRect(CGRect)	Modifica o caminho de recorte para ser a interseção do caminho atual e do retângulo fornecido.
ClipToRects(CGRect[])	Modifica o caminho de recorte atual para ser a insersão do caminho de recorte atual e da região especificada pelos retângulos fornecidos.
ClosePath()	Fecha e conclui o caminho atual.
ConcatCTM(CGAffineTransform)	Concatena o especificado `transform` na matriz de transformação atual.
ContextFillRects(CGRect[])	Contexto gráfico e primitivos a serem desenhados neles.
ConvertPointToUserSpace(CGPoint)	Converte um ponto de coordenadas de espaço do dispositivo em coordenadas de espaço do usuário.
ConvertRectToDeviceSpace(CGRect)	Converte um retângulo de coordenadas de espaço do usuário em coordenadas de espaço do dispositivo.
ConvertRectToUserSpace(CGRect)	Converte um retângulo de coordenadas de espaço do dispositivo em coordenadas de espaço do usuário.
ConvertSizeToDeviceSpace(CGSize)	Converte um tamanho de coordenadas de espaço do usuário em coordenadas de espaço do dispositivo.
ConvertSizeToUserSpace(CGSize)	Converte um tamanho de coordenadas de espaço do dispositivo em coordenadas de espaço do usuário.
CopyPath()	Retorna uma cópia profunda do caminho atual no contexto atual.
Dispose()	Libera os recursos usados pelo objeto CGContext.
Dispose(Boolean)	Libera os recursos usados pelo objeto CGContext.
DrawImage(CGRect, CGImage)	Contexto gráfico e primitivos a serem desenhados neles.
DrawLayer(CGLayer, CGPoint)	Desenha uma camada no contexto gráfico no ponto especificado.
DrawLayer(CGLayer, CGRect)	Desenha uma camada no contexto gráfico delimitado pelo retângulo especificado.
DrawLinearGradient(CGGradient, CGPoint, CGPoint, CGGradientDrawingOptions)	Contexto gráfico e primitivos a serem desenhados neles.
DrawPath(CGPathDrawingMode)	Desenha o CGContextcaminho atual do .
DrawPDFPage(CGPDFPage)	Renderiza o PDF `page`especificado.
DrawRadialGradient(CGGradient, CGPoint, nfloat, CGPoint, nfloat, CGGradientDrawingOptions)	Contexto gráfico e primitivos a serem desenhados neles.
DrawShading(CGShading)	Renderiza o especificado `shading`.
DrawTiledImage(CGRect, CGImage)	Contexto gráfico e primitivos a serem desenhados neles.
EndPage()	Chamado para indicar o fim de uma página em um contexto baseado em página.
EndTransparencyLayer()	Indica o fim de uma camada de transparência.
EOClip()	Modifica o caminho de recorte atual, usando a regra de Even-Odd.
EOFillPath()	Preenche o caminho atual, usando a regra Even-Odd.
FillEllipseInRect(CGRect)	Pinta a elipse definida por `rect`. Posteriormente, o caminho atual é redefinido.
FillPath()	Preenche o caminho atual, usando a regra winding diferente de zero.
FillRect(CGRect)	Pinta o especificado `rect`.
Finalize()	Finalizador para o objeto CGContext
Flush()	Força que todos os desenhos pendentes sejam renderizados.
GetClipBoundingBox()	A caixa delimitadora do caminho de recorte atual.
GetCTM()	Recupera a matriz de transformação de contexto atual.
GetPathBoundingBox()	Retorna a caixa delimitadora do caminho atual.
GetPathCurrentPoint()	O ponto atual no CGContextcaminho do .
GetUserSpaceToDeviceSpaceTransform()	O CGAffineTransform que mapeia as coordenadas de espaço do usuário em coordenadas de espaço do dispositivo.
IsPathEmpty()	Se o caminho atual contém subcaminhos.
MoveTo(nfloat, nfloat)	Inicia um sub-caminho na posição especificada.
PathContainsPoint(CGPoint, CGPathDrawingMode)	Contexto gráfico e primitivos a serem desenhados neles.
PointToDeviceSpace(CGPoint)	Retorna um novo PointF que converte o espaço `point` do usuário em espaço do dispositivo.
ReplacePathWithStrokedPath()	Substitui o caminho atual pela versão traçada do caminho, com base nos parâmetros de traço.
ResetClip()	Contexto gráfico e primitivos a serem desenhados neles.
RestoreState()	Define o estado do CGContext como era quando SaveState() foi chamado pela última vez.
RotateCTM(nfloat)	Gira a matriz de transformação atual por `angle` radianos, com valores positivos girando no sentido anti-horário.
SaveState()	Armazena o estado do CGContext. (Consulte RestoreState().)
ScaleCTM(nfloat, nfloat)	Dimensiona a matriz de transformação atual.
SelectFont(String, nfloat, CGTextEncoding)	Os desenvolvedores não devem usar esse método preterido. Os desenvolvedores devem usar a API 'CoreText'.
SetAllowsAntialiasing(Boolean)	Se o contexto permite a suavização.
SetAllowsFontSmoothing(Boolean)	Se o contexto permite suavização de fonte.
SetAllowsFontSubpixelQuantization(Boolean)	Se o contexto permite que os glifos sejam desenhados em locais de subpixel.
SetAllowsSubpixelPositioning(Boolean)	Se o contexto permite que os glifos sejam alinhados além dos limites de pixel.
SetAlpha(nfloat)	Define a opacidade do desenho, no intervalo 0,0 (transparente) como 1,0 (opaco).
SetBlendMode(CGBlendMode)	Especifica o modo de composição.
SetCharacterSpacing(nfloat)	Adiciona espaçamento adicional entre glifos.
SetFillColor(CGColor)	Define a cor de preenchimento para o especificado CGColor.
SetFillColor(nfloat, nfloat)	Define a cor de preenchimento como um nível cinza, no intervalo 0 (preto) como 1 (branco).
SetFillColor(nfloat, nfloat, nfloat, nfloat)	Define a cor de preenchimento para os valores RGBA especificados.
SetFillColor(nfloat, nfloat, nfloat, nfloat, nfloat)	Define a cor de preenchimento usando componentes de espaço de cor cmyk, além de um valor alfa.
SetFillColor(nfloat[])	Define a cor de preenchimento. SetFillColorSpace(CGColorSpace) deve ser chamado anteriormente.
SetFillColorSpace(CGColorSpace)	Especifica o CGColorSpace a ser usado no contexto.
SetFillPattern(CGPattern, nfloat[])	Define o padrão de preenchimento do contexto.
SetFlatness(nfloat)	A precisão dos caminhos curvo.
SetFont(CGFont)	Define o CGFont usado para renderizar texto.
SetFontSize(nfloat)	Define o tamanho da fonte usada para obter texto.
SetLineCap(CGLineCap)	Define o estilo para as extremidades das linhas.
SetLineDash(nfloat, nfloat[])	O padrão a ser usado para desenhar linhas tracejadas.
SetLineDash(nfloat, nfloat[], Int32)	Contexto gráfico e primitivos a serem desenhados neles.
SetLineJoin(CGLineJoin)	Define a maneira como as linhas são unidas.
SetLineWidth(nfloat)	Define a largura da linha traçada. A linha se estende por metade `w` para ambos os lados do caminho.
SetMiterLimit(nfloat)	Especifica o limite de miter para conexão de linhas.
SetPatternPhase(CGSize)	Converte o padrão antes de começar a bloco.
SetRenderingIntent(CGColorRenderingIntent)	Como as cores fora do espaço de cor de destino são tratadas.
SetShadow(CGSize, nfloat, CGColor)	Contexto gráfico e primitivos a serem desenhados neles.
SetShouldAntialias(Boolean)	Usado em conjunto com SetAllowsAntialiasing(Boolean) para habilitar ou desabilitar a suavização.
SetShouldSmoothFonts(Boolean)	Usado em conjunto com SetAllowsFontSmoothing(Boolean) para habilitar ou desabilitar a suavização de fonte.
SetShouldSubpixelPositionFonts(Boolean)	Usado em conjunto com SetAllowsSubpixelPositioning(Boolean) para habilitar ou desabilitar o alinhamento do glifo com pixels.
SetStrokeColor(CGColor)	Define a cor do traço.
SetStrokeColor(nfloat, nfloat)	Define a cor do traço como um valor de escala de cinza.
SetStrokeColor(nfloat, nfloat, nfloat, nfloat)	Define a cor do traço como uma cor RGBA.
SetStrokeColor(nfloat, nfloat, nfloat, nfloat, nfloat)	Define a cor do traço como uma cor CMYKA.
SetStrokeColor(nfloat[])	Define a cor do traço. Essa API terá um comportamento indefinido se você não definir o colorspace com antecedência.
SetStrokeColorSpace(CGColorSpace)	Define o CGColorSpace a ser usado com M:CoreGraphics.CGContext.SetStrokeColor(float[]).
SetStrokePattern(CGPattern, nfloat[])	Define o padrão de traço do contexto.
SetTextDrawingMode(CGTextDrawingMode)	Especifica como os glifos devem ser renderizados.
ShouldSubpixelQuantizeFonts(Boolean)	Com SetAllowsFontSubpixelQuantization(Boolean), determina se as fontes devem ser desenhadas em locais de subpixel.
ShowGlyphs(UInt16[])	Esse método foi preterido em favor de N:CoreText.
ShowGlyphs(UInt16[], Int32)	Esse método foi preterido em favor de N:CoreText.
ShowGlyphsAtPoint(nfloat, nfloat, UInt16[])	Contexto gráfico e primitivos a serem desenhados neles.
ShowGlyphsAtPoint(nfloat, nfloat, UInt16[], Int32)	Contexto gráfico e primitivos a serem desenhados neles.
ShowGlyphsAtPositions(UInt16[], CGPoint[], Int32)	Contexto gráfico e primitivos a serem desenhados neles.
ShowGlyphsWithAdvances(UInt16[], CGSize[], Int32)	Contexto gráfico e primitivos a serem desenhados neles.
ShowText(Byte[])	Esse método foi preterido em favor de N:CoreText.
ShowText(Byte[], Int32)	Esse método foi preterido em favor de N:CoreText.
ShowText(String)	Esse método foi preterido em favor de N:CoreText.
ShowText(String, Int32)	Esse método foi preterido em favor de N:CoreText.
ShowTextAtPoint(nfloat, nfloat, Byte[])	Contexto gráfico e primitivos a serem desenhados neles.
ShowTextAtPoint(nfloat, nfloat, Byte[], Int32)	Contexto gráfico e primitivos a serem desenhados neles.
ShowTextAtPoint(nfloat, nfloat, String)	Contexto gráfico e primitivos a serem desenhados neles.
ShowTextAtPoint(nfloat, nfloat, String, Int32)	Contexto gráfico e primitivos a serem desenhados neles.
StrokeEllipseInRect(CGRect)	Traça a elipse definida por `rect`. Posteriormente, o caminho atual é redefinido.
StrokeLineSegments(CGPoint[])	Traça as linhas definidas pelos pares em `points`. Posteriormente, o caminho atual é redefinido.
StrokePath()	Traça o caminho atual. Posteriormente, o caminho atual é redefinido.
StrokeRect(CGRect)	Traça o especificado `rect`. Posteriormente, o caminho atual é redefinido.
StrokeRectWithWidth(CGRect, nfloat)	Traça o `rect`. A linha estende metade de `width` para ambos os lados do `rect` perímetro.
Synchronize()	Marca um CGContext para atualização.
TranslateCTM(nfloat, nfloat)	Altera a origem do sistema de coordenadas do usuário.

Aplica-se a

Compartilhar via