Freigeben über


CGContext Klasse

Definition

Grafikkontext und Grundtypen, um sie zu zeichnen.

public class CGContext : IDisposable, ObjCRuntime.INativeObject
type CGContext = class
    interface INativeObject
    interface IDisposable
Vererbung
CGContext
Abgeleitet
Implementiert

Hinweise

A CGContext ist ein Quarz-2D-Ziel zum Zeichnen. Sie enthält Parameter und deren Zustände (festgelegt mit Funktionen wie M:CoreGraphics.CGContext.SetFillColor*) und Geräteinformationen (z. B ConvertSizeToDeviceSpace(CGSize). ). CGContexts kann einen Bildschirmbereich, eine Bitmap, ein PDF-Dokument oder einen Drucker darstellen.

Es gibt eine begrenzte Anzahl von CGContextS verfügbar, und die Anwendungsentwickler sollten gewissenhaft mit der Entsorgung nach der Verwendung umgehen. Im Allgemeinen bedeutet dies, den Zeichencode in using Blöcken zu platzieren, wie im folgenden Beispiel gezeigt:

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

Das Beispiel zeigt außerdem das sehr häufige Muster einer überschriebenen Draw(CGRect) Methode in einer benutzerdefinierten UIView Methode und die Verwendung von GetImageFromCurrentImageContext() , um den Aktuellen CGContext abzurufen, auf dem gezeichnet werden soll.

Konstruktoren

CGContext(IntPtr)

Erstellt einen CGContext aus einem nicht verwalteten CGContextRef-Handle.

Eigenschaften

Handle

Handle (Zeiger) auf die Darstellung des nicht verwalteten Objekts.

InterpolationQuality

Ein Hinweis für das Qualitätsniveau, das beim Interpolieren von Bildern (z. B. beim Skalieren) verwendet wird.

TextMatrix

Definiert die Transformation zwischen Textraum und Benutzerbereich. Unabhängig vom Zustand.CGContext

TextPosition

Die Position in Benutzerraumkoordinaten, an der Text gezeichnet werden soll.

Methoden

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

Grafikkontext und Grundtypen, um sie zu zeichnen.

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

Fügt dem aktuellen Pfad einen Bogen hinzu.

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

Fügt am aktuellen Punkt eine kubische Bézierkurve mit den angegebenen Steuerungsparametern hinzu.

AddEllipseInRect(CGRect)

Fügt eine Ellipse hinzu, die in die angegebene rectpasst.

AddLines(CGPoint[])

Fügt die angegebenen Zeilen dem aktuellen Pfad hinzu.

AddLineToPoint(nfloat, nfloat)

Fügt eine Linie vom aktuellen Punkt (siehe GetPathCurrentPoint()) an die angegebenen Koordinaten im Benutzerraum an.

AddPath(CGPath)

Fügt dem aktuellen Pfad den angegebenen Pfad hinzu.

AddQuadCurveToPoint(nfloat, nfloat, nfloat, nfloat)

Fügt dem aktuellen Pfad eine quadratische Bézierkurve hinzu.

AddRect(CGRect)

Fügt dem aktuellen Pfad einen rechteckigen Pfad hinzu.

AddRects(CGRect[])

Fügt dem aktuellen Pfad ein Array rechteckiger Pfade hinzu.

AsBitmapContext()

Wandelt den CGContext in einen CGBitmapContext um.

BeginPage(Nullable<CGRect>)

Grafikkontext und Grundtypen, um sie zu zeichnen.

BeginPath()

Startet einen neuen Pfad im Grafikkontext.

BeginTransparencyLayer(CGRect, NSDictionary)

Grafikkontext und Grundtypen, um sie zu zeichnen.

BeginTransparencyLayer(NSDictionary)

Mit EndTransparencyLayer()schließt Vorgänge auf einer vollständig transparenten Ebene ein.

ClearRect(CGRect)

Zeichnet das Rechteck transparent.

Clip()

Legt den aktuellen Pfad des Grafikkontexts als Beschneidungspfad fest.

ClipToMask(CGRect, CGImage)

Grafikkontext und Grundtypen, um sie zu zeichnen.

ClipToRect(CGRect)

Ändert den Beschneidungspfad so, dass er die Schnittmenge des aktuellen Pfads und des angegebenen Rechtecks darstellt.

ClipToRects(CGRect[])

Ändert den aktuellen Beschneidungspfad als Insersektion des aktuellen Beschneidungspfads und der durch die angegebenen Rechtecke angegebenen Region.

ClosePath()

Schließt und schließt den aktuellen Pfad ab.

ConcatCTM(CGAffineTransform)

Verkettet das angegebene transform mit der aktuellen Transformationsmatrix.

ContextFillRects(CGRect[])

Grafikkontext und Grundtypen, um sie zu zeichnen.

ConvertPointToUserSpace(CGPoint)

Konvertiert einen Punkt von Geräteraumkoordinaten in Benutzerraumkoordinaten.

ConvertRectToDeviceSpace(CGRect)

Konvertiert ein Rechteck von Benutzerraumkoordinaten in Geräteraumkoordinaten.

ConvertRectToUserSpace(CGRect)

Konvertiert ein Rechteck von Geräteraumkoordinaten in Benutzerraumkoordinaten.

ConvertSizeToDeviceSpace(CGSize)

Konvertiert eine Größe von Benutzerraumkoordinaten in Geräteraumkoordinaten.

ConvertSizeToUserSpace(CGSize)

Konvertiert eine Größe von Geräteraumkoordinaten in Benutzerraumkoordinaten.

CopyPath()

Gibt eine ausführliche Kopie des aktuellen Pfads im aktuellen Kontext zurück.

Dispose()

Gibt die vom CGContext-Objekt verwendeten Ressourcen frei.

Dispose(Boolean)

Gibt die vom CGContext-Objekt verwendeten Ressourcen frei.

DrawImage(CGRect, CGImage)

Grafikkontext und Grundtypen, um sie zu zeichnen.

DrawLayer(CGLayer, CGPoint)

Zeichnet eine Ebene am angegebenen Punkt in den Grafikkontext.

DrawLayer(CGLayer, CGRect)

Zeichnet eine Ebene in den Grafikkontext, der durch das angegebene Rechteck begrenzt ist.

DrawLinearGradient(CGGradient, CGPoint, CGPoint, CGGradientDrawingOptions)

Grafikkontext und Grundtypen, um sie zu zeichnen.

DrawPath(CGPathDrawingMode)

Zeichnet den CGContextaktuellen Pfad.

DrawPDFPage(CGPDFPage)

Rendert die angegebene PDF page.

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

Grafikkontext und Grundtypen, um sie zu zeichnen.

DrawShading(CGShading)

Rendert den angegebenen shading.

DrawTiledImage(CGRect, CGImage)

Grafikkontext und Grundtypen, um sie zu zeichnen.

EndPage()

Wird aufgerufen, um das Ende einer Seite in einem seitenbasierten Kontext anzugeben.

EndTransparencyLayer()

Gibt das Ende einer Transparenzebene an.

EOClip()

Ändert den aktuellen Beschneidungspfad mithilfe der Even-Odd-Regel.

EOFillPath()

Füllt den aktuellen Pfad unter Verwendung der Even-Odd-Regel aus.

FillEllipseInRect(CGRect)

Zeichnet die durch rectdefinierte Ellipse. Anschließend wird der aktuelle Pfad zurückgesetzt.

FillPath()

Füllt den aktuellen Pfad unter Verwendung der Non-Zero-Wicklungsregel aus.

FillRect(CGRect)

Zeichnet den angegebenen rect.

Finalize()

Finalizer für das CGContext-Objekt

Flush()

Erzwingt, dass alle ausstehenden Zeichnungen gerendert werden.

GetClipBoundingBox()

Das begrenzungsfeld des aktuellen Beschneidungspfads.

GetCTM()

Ruft die aktuelle Kontexttransformationsmatrix ab.

GetPathBoundingBox()

Gibt das Begrenzungsfeld für den aktuellen Pfad zurück.

GetPathCurrentPoint()

Der aktuelle Punkt im CGContextPfad des Pfads.

GetUserSpaceToDeviceSpaceTransform()

Die CGAffineTransform , die Benutzerraumkoordinaten in Geräteraumkoordinaten ordnet.

IsPathEmpty()

Gibt an, ob der aktuelle Pfad Unterpfade enthält.

MoveTo(nfloat, nfloat)

Beginnt einen Unterpfad an der angegebenen Position.

PathContainsPoint(CGPoint, CGPathDrawingMode)

Grafikkontext und Grundtypen, um sie zu zeichnen.

PointToDeviceSpace(CGPoint)

Gibt einen neuen PointF zurück, der den Benutzerbereich point in Gerätebereich konvertiert.

ReplacePathWithStrokedPath()

Ersetzt den aktuellen Pfad durch die Strichversion des Pfads basierend auf den Strichparemetern.

ResetClip()

Grafikkontext und Grundtypen, um sie zu zeichnen.

RestoreState()

Legt den Zustand von auf fest CGContext , zu dem es zuletzt SaveState() aufgerufen wurde.

RotateCTM(nfloat)

Rotiert die aktuelle Transformationsmatrix um angle Bogenmaße, wobei sich positive Werte gegen den Uhrzeigersinn drehen.

SaveState()

Speichert den Status von CGContext. (Siehe RestoreState().)

ScaleCTM(nfloat, nfloat)

Skaliert die aktuelle Transformationsmatrix.

SelectFont(String, nfloat, CGTextEncoding)

Entwickler sollten diese veraltete Methode nicht verwenden. Entwickler sollten stattdessen die "CoreText"-API verwenden.

SetAllowsAntialiasing(Boolean)

Gibt an, ob der Kontext die Antialiasierung zulässt.

SetAllowsFontSmoothing(Boolean)

Gibt an, ob der Kontext die Schriftglättung zulässt.

SetAllowsFontSubpixelQuantization(Boolean)

Gibt an, ob der Kontext das Zeichnen von Glyphen an Subpixelpositionen zulässt.

SetAllowsSubpixelPositioning(Boolean)

Gibt an, ob der Kontext es zulässt, dass Glyphen nicht an Pixelgrenzen ausgerichtet werden können.

SetAlpha(nfloat)

Legt die Deckkraft für das Zeichnen im Bereich 0,0 (transparent) auf 1,0 (undurchsichtig) fest.

SetBlendMode(CGBlendMode)

Gibt den Compositing-Modus an.

SetCharacterSpacing(nfloat)

Fügt zusätzliche Abstände zwischen Glyphen hinzu.

SetFillColor(CGColor)

Legt die Füllfarbe auf die angegebene CGColorfest.

SetFillColor(nfloat, nfloat)

Legt die Füllfarbe auf eine Graustufe im Bereich 0 (schwarz) bis 1 (weiß) fest.

SetFillColor(nfloat, nfloat, nfloat, nfloat)

Legt die Füllfarbe auf die angegebenen RGBA-Werte fest.

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

Legt die Füllfarbe mithilfe von CMYK-Farbraumkomponenten und einem Alphawert fest.

SetFillColor(nfloat[])

Legt die Füllfarbe fest. SetFillColorSpace(CGColorSpace) muss vor aufgerufen werden.

SetFillColorSpace(CGColorSpace)

Gibt den an, der CGColorSpace im Kontext verwendet werden soll.

SetFillPattern(CGPattern, nfloat[])

Legt das Füllmuster des Kontexts fest.

SetFlatness(nfloat)

Die Genauigkeit von gekrümmten Pfaden.

SetFont(CGFont)

Legt die zum Rendern von CGFont Text verwendete fest.

SetFontSize(nfloat)

Legt die Größe der Schriftart fest, die zum Erneuten von Text verwendet wird.

SetLineCap(CGLineCap)

Legt den Stil für die Zeilenenden fest.

SetLineDash(nfloat, nfloat[])

Das Muster, das zum Zeichnen gestrichelter Linien verwendet werden soll.

SetLineDash(nfloat, nfloat[], Int32)

Grafikkontext und Grundtypen, um sie zu zeichnen.

SetLineJoin(CGLineJoin)

Legt fest, wie Zeilen verknüpft werden.

SetLineWidth(nfloat)

Legt die Breite der Strichlinie fest. Die Linie erstreckt sich zur Hälfte w zu beiden Seiten des Pfads.

SetMiterLimit(nfloat)

Gibt die Mitergrenze für Verbindungslinien an.

SetPatternPhase(CGSize)

Übersetzt das Muster, bevor es mit dem Kacheln beginnt.

SetRenderingIntent(CGColorRenderingIntent)

Wie Farben außerhalb des Zielfarbraums behandelt werden.

SetShadow(CGSize, nfloat, CGColor)

Grafikkontext und Grundtypen, um sie zu zeichnen.

SetShouldAntialias(Boolean)

Wird in Verbindung mit SetAllowsAntialiasing(Boolean) verwendet, um antialiasing zu aktivieren oder zu deaktivieren.

SetShouldSmoothFonts(Boolean)

Wird in Verbindung mit SetAllowsFontSmoothing(Boolean) verwendet, um die Schriftglättung zu aktivieren oder zu deaktivieren.

SetShouldSubpixelPositionFonts(Boolean)

Wird in Verbindung mit SetAllowsSubpixelPositioning(Boolean) verwendet, um die Ausrichtung der Glyphen mit Pixeln zu aktivieren oder zu deaktivieren.

SetStrokeColor(CGColor)

Legt die Strichfarbe fest.

SetStrokeColor(nfloat, nfloat)

Legt die Strichfarbe auf einen Graustufenwert fest.

SetStrokeColor(nfloat, nfloat, nfloat, nfloat)

Legt die Strichfarbe auf eine RGBA-Farbe fest.

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

Legt die Strichfarbe auf eine CMYKA-Farbe fest.

SetStrokeColor(nfloat[])

Legt die Strichfarbe fest. Diese API weist ein nicht definiertes Verhalten auf, wenn Sie den Farbraum nicht zuvor festlegen.

SetStrokeColorSpace(CGColorSpace)

Legt fest, dass mit CGColorSpaceM:CoreGraphics.CGContext.SetStrokeColor(float[]) verwendet werden soll.

SetStrokePattern(CGPattern, nfloat[])

Legt das Strichmuster des Kontexts fest.

SetTextDrawingMode(CGTextDrawingMode)

Gibt an, wie Glyphen gerendert werden sollen.

ShouldSubpixelQuantizeFonts(Boolean)

Mit SetAllowsFontSubpixelQuantization(Boolean)bestimmt, ob Schriftarten an Unterpixelpositionen gezeichnet werden sollen.

ShowGlyphs(UInt16[])

Diese Methode wurde zugunsten von CoreText veraltet.

ShowGlyphs(UInt16[], Int32)

Diese Methode wurde zugunsten von CoreText veraltet.

ShowGlyphsAtPoint(nfloat, nfloat, UInt16[])

Grafikkontext und Grundtypen, um sie zu zeichnen.

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

Grafikkontext und Grundtypen, um sie zu zeichnen.

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

Grafikkontext und Grundtypen, um sie zu zeichnen.

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

Grafikkontext und Grundtypen, um sie zu zeichnen.

ShowText(Byte[])

Diese Methode wurde zugunsten von CoreText veraltet.

ShowText(Byte[], Int32)

Diese Methode wurde zugunsten von CoreText veraltet.

ShowText(String)

Diese Methode wurde zugunsten von CoreText veraltet.

ShowText(String, Int32)

Diese Methode wurde zugunsten von CoreText veraltet.

ShowTextAtPoint(nfloat, nfloat, Byte[])

Grafikkontext und Grundtypen, um sie zu zeichnen.

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

Grafikkontext und Grundtypen, um sie zu zeichnen.

ShowTextAtPoint(nfloat, nfloat, String)

Grafikkontext und Grundtypen, um sie zu zeichnen.

ShowTextAtPoint(nfloat, nfloat, String, Int32)

Grafikkontext und Grundtypen, um sie zu zeichnen.

StrokeEllipseInRect(CGRect)

Stricht die durch rectdefinierte Ellipse. Anschließend wird der aktuelle Pfad zurückgesetzt.

StrokeLineSegments(CGPoint[])

Stricht die Linien, die von den Paaren in pointsdefiniert werden. Anschließend wird der aktuelle Pfad zurückgesetzt.

StrokePath()

Stricht den aktuellen Pfad. Anschließend wird der aktuelle Pfad zurückgesetzt.

StrokeRect(CGRect)

Stricht den angegebenen rect. Anschließend wird der aktuelle Pfad zurückgesetzt.

StrokeRectWithWidth(CGRect, nfloat)

Stricht den rect. Die Linie erstreckt sich zur Hälfte width auf beide Seiten des rect Umkreises.

Synchronize()

Markiert ein CGContext für update.

TranslateCTM(nfloat, nfloat)

Ändert den Ursprung des Benutzerkoordinatensystems.

Gilt für:

Weitere Informationen