CGContext Classe

Definizione

Contesto grafico e primitive da disegnare.

public class CGContext : IDisposable, ObjCRuntime.INativeObject
type CGContext = class
    interface INativeObject
    interface IDisposable
Ereditarietà
CGContext
Derivato
Implementazioni

Commenti

Un CGContext è una destinazione di quarzi 2D per il disegno. Contiene i parametri e i relativi stati (impostati con funzioni come M:CoreGraphics.CGContext.SetFillColor*) e le informazioni sul dispositivo (ad esempio, ConvertSizeToDeviceSpace(CGSize)). CGContexts può rappresentare un'area dello schermo, una bitmap, un documento PDF o una stampante.

Ci sono un numero limitato di CGContexts disponibili e gli sviluppatori di applicazioni devono essere coscienti di eliminarli dopo l'uso. Ciò significa in genere inserire il codice di disegno in using blocchi, come illustrato nell'esempio seguente:

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

L'esempio mostra inoltre il modello molto comune di un metodo sottoposto Draw(CGRect) a override in un oggetto personalizzato UIView e l'uso di GetImageFromCurrentImageContext() per recuperare l'oggetto corrente CGContext su cui disegnare.

Costruttori

CGContext(IntPtr)

Crea un oggetto CGContext da un handle CGContextRef non gestito.

Proprietà

Handle

Gestire (puntatore) alla rappresentazione dell'oggetto non gestita.

InterpolationQuality

Suggerimento per il livello di qualità usato durante l'interpolazione delle immagini, ad esempio durante la scalabilità.

TextMatrix

Definisce la trasformazione tra spazio di testo e spazio utente. Indipendentemente dallo CGContextstato di .

TextPosition

Posizione, nelle coordinate dello spazio utente, in corrispondenza della quale disegnare il testo.

Metodi

AddArc(nfloat, nfloat, nfloat, nfloat, nfloat, Boolean)

Contesto grafico e primitive da disegnare.

AddArcToPoint(nfloat, nfloat, nfloat, nfloat, nfloat)

Aggiunge un arco al percorso corrente.

AddCurveToPoint(nfloat, nfloat, nfloat, nfloat, nfloat, nfloat)

Aggiunge una curva di Bézier cubica al punto corrente, con i parametri di controllo specificati.

AddEllipseInRect(CGRect)

Aggiunge un puntini di sospensione che si adatta all'oggetto specificato rect.

AddLines(CGPoint[])

Aggiunge le righe indicate al percorso corrente.

AddLineToPoint(nfloat, nfloat)

Aggiunge una riga dal punto corrente (vedere GetPathCurrentPoint()) alle coordinate specificate nello spazio utente.

AddPath(CGPath)

Aggiunge il percorso specificato al percorso corrente.

AddQuadCurveToPoint(nfloat, nfloat, nfloat, nfloat)

Aggiunge una curva quadratica Bézier al percorso corrente.

AddRect(CGRect)

Aggiunge un percorso rettangolare al percorso corrente.

AddRects(CGRect[])

Aggiunge una matrice di percorsi rettangolari al percorso corrente.

AsBitmapContext()

Esegue il cast di CGContext in un oggetto CGBitmapContext.

BeginPage(Nullable<CGRect>)

Contesto grafico e primitive da disegnare.

BeginPath()

Avvia un nuovo percorso nel contesto grafico.

BeginTransparencyLayer(CGRect, NSDictionary)

Contesto grafico e primitive da disegnare.

BeginTransparencyLayer(NSDictionary)

Con EndTransparencyLayer(), racchiude le operazioni su un livello completamente trasparente.

ClearRect(CGRect)

Disegna il rettangolo in modo trasparente.

Clip()

Imposta il percorso corrente del contesto grafico per essere il percorso di ritaglio.

ClipToMask(CGRect, CGImage)

Contesto grafico e primitive da disegnare.

ClipToRect(CGRect)

Modifica il percorso di ritaglio per essere l'intersezione del percorso corrente e il rettangolo fornito.

ClipToRects(CGRect[])

Modifica il percorso corrente di ritaglio per essere l'insezione del percorso di ritaglio corrente e l'area specificata dai rettangoli specificati.

ClosePath()

Chiude e completa il percorso corrente.

ConcatCTM(CGAffineTransform)

Concatena l'oggetto specificato transform nella matrice di trasformazione corrente.

ContextFillRects(CGRect[])

Contesto grafico e primitive da disegnare.

ConvertPointToUserSpace(CGPoint)

Converte un punto dalle coordinate dello spazio del dispositivo alle coordinate dello spazio utente.

ConvertRectToDeviceSpace(CGRect)

Converte un rettangolo dalle coordinate dello spazio utente alle coordinate dello spazio del dispositivo.

ConvertRectToUserSpace(CGRect)

Converte un rettangolo dalle coordinate dello spazio del dispositivo alle coordinate dello spazio utente.

ConvertSizeToDeviceSpace(CGSize)

Converte una dimensione dalle coordinate dello spazio utente alle coordinate dello spazio dei dispositivi.

ConvertSizeToUserSpace(CGSize)

Converte una dimensione dalle coordinate dello spazio del dispositivo alle coordinate dello spazio utente.

CopyPath()

Restituisce una copia profonda del percorso corrente nel contesto corrente.

Dispose()

Rilascia le risorse usate dall'oggetto CGContext.

Dispose(Boolean)

Rilascia le risorse usate dall'oggetto CGContext.

DrawImage(CGRect, CGImage)

Contesto grafico e primitive da disegnare.

DrawLayer(CGLayer, CGPoint)

Disegna un livello nel contesto grafico al punto specificato.

DrawLayer(CGLayer, CGRect)

Disegna un livello nel contesto grafico associato al rettangolo specificato.

DrawLinearGradient(CGGradient, CGPoint, CGPoint, CGGradientDrawingOptions)

Contesto grafico e primitive da disegnare.

DrawPath(CGPathDrawingMode)

Disegna il CGContextpercorso corrente.

DrawPDFPage(CGPDFPage)

Esegue il rendering del pdf pagespecificato.

DrawRadialGradient(CGGradient, CGPoint, nfloat, CGPoint, nfloat, CGGradientDrawingOptions)

Contesto grafico e primitive da disegnare.

DrawShading(CGShading)

Esegue il rendering dell'oggetto specificato shading.

DrawTiledImage(CGRect, CGImage)

Contesto grafico e primitive da disegnare.

EndPage()

Chiamato per indicare la fine di una pagina in un contesto basato su pagine.

EndTransparencyLayer()

Indica la fine di un livello di trasparenza.

EOClip()

Modifica il percorso di ritaglio corrente usando la regola di Even-Odd.

EOFillPath()

Riempie il percorso corrente usando la regola di Even-Odd.

FillEllipseInRect(CGRect)

Disegna i puntini di sospensione definiti da rect. Successivamente, il percorso corrente viene reimpostato.

FillPath()

Riempie il percorso corrente usando la regola di avvolgimento non zero.

FillRect(CGRect)

Disegna l'oggetto specificato rect.

Finalize()

Finalizzatore per l'oggetto CGContext

Flush()

Forza il rendering di tutti i disegni in sospeso.

GetClipBoundingBox()

Casella di selezione del percorso di ritaglio corrente.

GetCTM()

Recupera la matrice di trasformazione contesto corrente.

GetPathBoundingBox()

Restituisce il rettangolo di selezione per il percorso corrente.

GetPathCurrentPoint()

Punto corrente nel CGContextpercorso di .

GetUserSpaceToDeviceSpaceTransform()

Oggetto CGAffineTransform che esegue il mapping delle coordinate dello spazio utente nelle coordinate dello spazio dei dispositivi.

IsPathEmpty()

Se il percorso corrente contiene eventuali sottopath.

MoveTo(nfloat, nfloat)

Inizia un percorso secondario nella posizione specificata.

PathContainsPoint(CGPoint, CGPathDrawingMode)

Contesto grafico e primitive da disegnare.

PointToDeviceSpace(CGPoint)

Restituisce un nuovo oggetto PointF che converte lo spazio utente nello spazio point dei dispositivi.

ReplacePathWithStrokedPath()

Sostituisce il percorso corrente con la versione con tratto del percorso, in base ai paremetri del tratto.

ResetClip()

Contesto grafico e primitive da disegnare.

RestoreState()

Imposta lo stato dell'oggetto CGContext su quello che era quando SaveState() è stato chiamato.

RotateCTM(nfloat)

Ruota la matrice di trasformazione corrente da angle radianti, con valori positivi che ruotano in senso antiorario.

SaveState()

Archivia lo stato di CGContext. Per informazioni, vedere RestoreState().

ScaleCTM(nfloat, nfloat)

Ridimensiona la matrice di trasformazione corrente.

SelectFont(String, nfloat, CGTextEncoding)

Gli sviluppatori non devono usare questo metodo deprecato. Gli sviluppatori devono usare invece l'API 'CoreText'.

SetAllowsAntialiasing(Boolean)

Se il contesto consente l'antialiasing.

SetAllowsFontSmoothing(Boolean)

Indica se il contesto consente lo smoothing del tipo di carattere.

SetAllowsFontSubpixelQuantization(Boolean)

Se il contesto consente di disegnare glifi in posizioni subpixel.

SetAllowsSubpixelPositioning(Boolean)

Se il contesto consente l'allineamento dei glifi diverso dai limiti pixel.

SetAlpha(nfloat)

Imposta l'opacità per il disegno, nell'intervallo 0.0 (trasparente) su 1.0 (opaco).

SetBlendMode(CGBlendMode)

Specifica la modalità di composizione.

SetCharacterSpacing(nfloat)

Aggiunge spaziatura aggiuntiva tra glifi.

SetFillColor(CGColor)

Imposta il colore di riempimento sull'oggetto specificato CGColor.

SetFillColor(nfloat, nfloat)

Imposta il colore di riempimento su un livello grigio, nell'intervallo 0 (nero) su 1 (bianco).

SetFillColor(nfloat, nfloat, nfloat, nfloat)

Imposta il colore di riempimento sui valori RGBA specificati.

SetFillColor(nfloat, nfloat, nfloat, nfloat, nfloat)

Imposta il colore di riempimento usando i componenti dello spazio dei colori CMYK, oltre a un valore alfa.

SetFillColor(nfloat[])

Imposta il colore di riempimento. SetFillColorSpace(CGColorSpace) deve essere chiamato prima.

SetFillColorSpace(CGColorSpace)

Specifica l'oggetto CGColorSpace da usare nel contesto.

SetFillPattern(CGPattern, nfloat[])

Imposta il modello di riempimento del contesto.

SetFlatness(nfloat)

Accuratezza dei percorsi curvati.

SetFont(CGFont)

Imposta l'oggetto utilizzato per eseguire il rendering del CGFont testo.

SetFontSize(nfloat)

Imposta le dimensioni del tipo di carattere utilizzato per rendere il testo.

SetLineCap(CGLineCap)

Imposta lo stile per le estremità delle righe.

SetLineDash(nfloat, nfloat[])

Modello da utilizzare per il disegno di linee tratteggiate.

SetLineDash(nfloat, nfloat[], Int32)

Contesto grafico e primitive da disegnare.

SetLineJoin(CGLineJoin)

Imposta la modalità di aggiunta delle righe.

SetLineWidth(nfloat)

Imposta la larghezza della linea con tratto. La linea si estende per metà w a uno dei lati del percorso.

SetMiterLimit(nfloat)

Specifica il limite di miter per la connessione delle linee.

SetPatternPhase(CGSize)

Converte il modello prima di iniziare a riquadrirlo.

SetRenderingIntent(CGColorRenderingIntent)

Come vengono gestiti i colori all'esterno dello spazio dei colori di destinazione.

SetShadow(CGSize, nfloat, CGColor)

Contesto grafico e primitive da disegnare.

SetShouldAntialias(Boolean)

Usato in combinazione con SetAllowsAntialiasing(Boolean) per abilitare o disabilitare l'antialiasing.

SetShouldSmoothFonts(Boolean)

Usato in combinazione con SetAllowsFontSmoothing(Boolean) per abilitare o disabilitare lo smoothing dei tipi di carattere.

SetShouldSubpixelPositionFonts(Boolean)

Usato in combinazione con SetAllowsSubpixelPositioning(Boolean) per abilitare o disabilitare l'allineamento del glifo con pixel.

SetStrokeColor(CGColor)

Imposta il colore del tratto.

SetStrokeColor(nfloat, nfloat)

Imposta il colore del tratto su un valore di scala grigia.

SetStrokeColor(nfloat, nfloat, nfloat, nfloat)

Imposta il colore del tratto su un colore RGBA.

SetStrokeColor(nfloat, nfloat, nfloat, nfloat, nfloat)

Imposta il colore del tratto su un colore CMYKA.

SetStrokeColor(nfloat[])

Imposta il colore del tratto. Questa API ha un comportamento non definito se non si imposta lo spazio colori in anticipo.

SetStrokeColorSpace(CGColorSpace)

Imposta l'oggetto CGColorSpace da usare con ]).

SetStrokePattern(CGPattern, nfloat[])

Imposta il motivo del tratto del contesto.

SetTextDrawingMode(CGTextDrawingMode)

Specifica la modalità di rendering dei glifi.

ShouldSubpixelQuantizeFonts(Boolean)

Con SetAllowsFontSubpixelQuantization(Boolean), determina se i tipi di carattere devono essere disegnati in posizioni subpixel.

ShowGlyphs(UInt16[])

Questo metodo è stato deprecato a favore di N:CoreText.

ShowGlyphs(UInt16[], Int32)

Questo metodo è stato deprecato a favore di N:CoreText.

ShowGlyphsAtPoint(nfloat, nfloat, UInt16[])

Contesto grafico e primitive da disegnare.

ShowGlyphsAtPoint(nfloat, nfloat, UInt16[], Int32)

Contesto grafico e primitive da disegnare.

ShowGlyphsAtPositions(UInt16[], CGPoint[], Int32)

Contesto grafico e primitive da disegnare.

ShowGlyphsWithAdvances(UInt16[], CGSize[], Int32)

Contesto grafico e primitive da disegnare.

ShowText(Byte[])

Questo metodo è stato deprecato a favore di N:CoreText.

ShowText(Byte[], Int32)

Questo metodo è stato deprecato a favore di N:CoreText.

ShowText(String)

Questo metodo è stato deprecato a favore di N:CoreText.

ShowText(String, Int32)

Questo metodo è stato deprecato a favore di N:CoreText.

ShowTextAtPoint(nfloat, nfloat, Byte[])

Contesto grafico e primitive da disegnare.

ShowTextAtPoint(nfloat, nfloat, Byte[], Int32)

Contesto grafico e primitive da disegnare.

ShowTextAtPoint(nfloat, nfloat, String)

Contesto grafico e primitive da disegnare.

ShowTextAtPoint(nfloat, nfloat, String, Int32)

Contesto grafico e primitive da disegnare.

StrokeEllipseInRect(CGRect)

Traccia l'ellisse definita da rect. Successivamente, il percorso corrente viene reimpostato.

StrokeLineSegments(CGPoint[])

Traccia le linee definite dalle coppie in points. Successivamente, il percorso corrente viene reimpostato.

StrokePath()

Traccia il percorso corrente. Successivamente, il percorso corrente viene reimpostato.

StrokeRect(CGRect)

Traccia l'oggetto specificato rect. Successivamente, il percorso corrente viene reimpostato.

StrokeRectWithWidth(CGRect, nfloat)

Traccia l'oggetto rect. La linea estende la metà di width a entrambi i lati del rect perimetro.

Synchronize()

Contrassegna un CGContext oggetto per l'aggiornamento.

TranslateCTM(nfloat, nfloat)

Modifica l'origine del sistema di coordinate utente.

Si applica a

Vedi anche