CGContext 類別

定義

命名空間:

CoreGraphics

組件:

Xamarin.iOS.dll

要在其中繪製的圖形內容和基本類型。

public class CGContext : IDisposable, ObjCRuntime.INativeObject

type CGContext = class
    interface INativeObject
    interface IDisposable

繼承

Object

CGContext

衍生

CoreGraphics.CGBitmapContext

CoreGraphics.CGContextPDF

實作

INativeObject IDisposable

備註

是 CGContext 繪圖的 2D 目的地。 它會保留參數及其狀態 (設定，例如 M：CoreGraphics.CGCoNtext.SetFillColor*) 和裝置資訊 (，例如 ConvertSizeToDeviceSpace(CGSize) ，) 。 CGContexts 可能代表螢幕區域、點陣圖、PDF 檔或印表機。

可用的數量 CGContext 有限，應用程式開發人員應該在使用後就很謹慎地處置它們。 一般而言，這表示將繪圖程式碼 using 放入區塊中，如下列範例所示：

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

此範例也會顯示自訂 UIView 中覆寫 Draw(CGRect) 方法的非常常見模式，以及用來 GetImageFromCurrentImageContext() 擷取要繪製的目前 CGContext 模式。

建構函式

CGContext(IntPtr)

從 Unmanaged CGCoNtextRef 控制碼建立 CGCoNtext。

屬性

Handle	處理非受控物件標記法) (指標。
InterpolationQuality	例如，縮放) 時，插補影像時所使用的品質層級提示 (。
TextMatrix	定義文字空間與使用者空間之間的轉換。 CGContext與 狀態無關。
TextPosition	使用者空間座標中要繪製文字的位置。

方法

AddArc(nfloat, nfloat, nfloat, nfloat, nfloat, Boolean)	要在其中繪製的圖形內容和基本類型。
AddArcToPoint(nfloat, nfloat, nfloat, nfloat, nfloat)	將弧線加入至目前的路徑。
AddCurveToPoint(nfloat, nfloat, nfloat, nfloat, nfloat, nfloat)	使用指定的控制項參數，在目前點加入立方體 Bézier 曲線。
AddEllipseInRect(CGRect)	加入符合指定 rect 之 的省略號。
AddLines(CGPoint[])	將指定的行新增至目前的路徑。
AddLineToPoint(nfloat, nfloat)	將目前點的線條附加 () GetPathCurrentPoint() 至使用者空間中的指定座標。
AddPath(CGPath)	將指定的路徑加入至目前的路徑。
AddQuadCurveToPoint(nfloat, nfloat, nfloat, nfloat)	將二次方 Bézier 曲線新增至目前路徑。
AddRect(CGRect)	將矩形路徑新增至目前路徑。
AddRects(CGRect[])	將矩形路徑的陣列新增至目前的路徑。
AsBitmapContext()	將 CGCoNtext 轉換成 CGBitmapCoNtext。
BeginPage(Nullable<CGRect>)	要在其中繪製的圖形內容和基本類型。
BeginPath()	在圖形內容中啟動新的路徑。
BeginTransparencyLayer(CGRect, NSDictionary)	要在其中繪製的圖形內容和基本類型。
BeginTransparencyLayer(NSDictionary)	使用 EndTransparencyLayer() 時，會在完全透明層上封入作業。
ClearRect(CGRect)	以透明方式繪製矩形。
Clip()	將圖形內容的目前路徑設定為裁剪路徑。
ClipToMask(CGRect, CGImage)	要在其中繪製的圖形內容和基本類型。
ClipToRect(CGRect)	將裁剪路徑修改為目前路徑和所提供矩形的交集。
ClipToRects(CGRect[])	將目前的裁剪路徑修改為目前裁剪路徑的縮進路徑，以及所提供矩形所指定的區域。
ClosePath()	關閉並完成目前的路徑。
ConcatCTM(CGAffineTransform)	將指定的 transform 串連到目前的轉換矩陣。
ContextFillRects(CGRect[])	要在其中繪製的圖形內容和基本類型。
ConvertPointToUserSpace(CGPoint)	將點從裝置空間座標轉換為使用者空間座標。
ConvertRectToDeviceSpace(CGRect)	將矩形從使用者空間座標轉換為裝置空間座標。
ConvertRectToUserSpace(CGRect)	將矩形從裝置空間座標轉換為使用者空間座標。
ConvertSizeToDeviceSpace(CGSize)	將大小從使用者空間座標轉換為裝置空間座標。
ConvertSizeToUserSpace(CGSize)	將大小從裝置空間座標轉換為使用者空間座標。
CopyPath()	傳回目前內容中目前路徑的深層複本。
Dispose()	釋放 CGCoNtext 物件所使用的資源。
Dispose(Boolean)	釋放 CGCoNtext 物件所使用的資源。
DrawImage(CGRect, CGImage)	要在其中繪製的圖形內容和基本類型。
DrawLayer(CGLayer, CGPoint)	將圖層繪製到指定點的圖形內容中。
DrawLayer(CGLayer, CGRect)	將圖層繪製到指定的矩形所系結的圖形內容中。
DrawLinearGradient(CGGradient, CGPoint, CGPoint, CGGradientDrawingOptions)	要在其中繪製的圖形內容和基本類型。
DrawPath(CGPathDrawingMode)	CGContext繪製 的目前路徑。
DrawPDFPage(CGPDFPage)	轉譯指定的 PDF page 。
DrawRadialGradient(CGGradient, CGPoint, nfloat, CGPoint, nfloat, CGGradientDrawingOptions)	要在其中繪製的圖形內容和基本類型。
DrawShading(CGShading)	轉譯指定的 shading 。
DrawTiledImage(CGRect, CGImage)	要在其中繪製的圖形內容和基本類型。
EndPage()	呼叫 以指出頁面型內容中頁面的結尾。
EndTransparencyLayer()	表示透明度圖層的結尾。
EOClip()	使用Even-Odd規則修改目前的裁剪路徑。
EOFillPath()	使用Even-Odd規則填入目前的路徑。
FillEllipseInRect(CGRect)	繪製 所 rect 定義的省略號。 之後，會重設目前的路徑。
FillPath()	使用非零折線規則填滿目前的路徑。
FillRect(CGRect)	繪製指定的 rect 。
Finalize()	CGCoNtext 物件的完成項
Flush()	強制轉譯所有擱置的繪圖。
GetClipBoundingBox()	目前裁剪路徑的周框方塊。
GetCTM()	擷取目前的內容轉換矩陣。
GetPathBoundingBox()	傳回目前路徑的周框方塊。
GetPathCurrentPoint()	路徑中的 CGContext 目前點。
GetUserSpaceToDeviceSpaceTransform()	，會將 CGAffineTransform 使用者空間座標組應至裝置空間座標。
IsPathEmpty()	目前路徑是否包含任何子路徑。
MoveTo(nfloat, nfloat)	開始位於指定位置的子路徑。
PathContainsPoint(CGPoint, CGPathDrawingMode)	要在其中繪製的圖形內容和基本類型。
PointToDeviceSpace(CGPoint)	傳回新的 PointF ，將使用者空間 point 轉換成裝置空間。
ReplacePathWithStrokedPath()	根據筆劃剖析器，將目前路徑取代為路徑的筆劃版本。
ResetClip()	要在其中繪製的圖形內容和基本類型。
RestoreState()	將 的狀態 CGContext 設定為上次呼叫時 SaveState() 的狀態。
RotateCTM(nfloat)	以弧度旋轉目前的轉換矩陣 angle ，並反時針旋轉正值。
SaveState()	儲存 的狀態 CGContext 。 (請參閱RestoreState().)
ScaleCTM(nfloat, nfloat)	調整目前的轉換矩陣。
SelectFont(String, nfloat, CGTextEncoding)	開發人員不應該使用此已被取代的方法。 開發人員應該改用 'CoreText' API。
SetAllowsAntialiasing(Boolean)	內容是否允許反鋸齒。
SetAllowsFontSmoothing(Boolean)	內容是否允許字型平滑。
SetAllowsFontSubpixelQuantization(Boolean)	內容是否允許在子圖元位置繪製圖像。
SetAllowsSubpixelPositioning(Boolean)	內容是否允許圖像對齊圖元界限以外的字元。
SetAlpha(nfloat)	將繪製的不透明度設定為 0.0 (透明) 範圍中的不透明) 為 1.0 (不透明) 。
SetBlendMode(CGBlendMode)	指定撰寫模式。
SetCharacterSpacing(nfloat)	新增字元之間的額外間距。
SetFillColor(CGColor)	將填滿色彩設定為指定的 CGColor 。
SetFillColor(nfloat, nfloat)	將填滿色彩設定為灰色層級，範圍介於 0 (黑色) 設為 1 (白色) 。
SetFillColor(nfloat, nfloat, nfloat, nfloat)	將填滿色彩設定為指定的 RGBA 值。
SetFillColor(nfloat, nfloat, nfloat, nfloat, nfloat)	使用 CMYK 色彩空間元件設定填滿色彩，加上 Alpha 值。
SetFillColor(nfloat[])	設定填滿色彩。 SetFillColorSpace(CGColorSpace) 必須先在 之前呼叫。
SetFillColorSpace(CGColorSpace)	指定要 CGColorSpace 用於內容中的 。
SetFillPattern(CGPattern, nfloat[])	設定內容的填滿圖樣。
SetFlatness(nfloat)	曲線路徑的精確度。
SetFont(CGFont)	CGFont設定用來轉譯文字的 。
SetFontSize(nfloat)	設定用來轉譯文字的字型大小。
SetLineCap(CGLineCap)	設定線條結尾的樣式。
SetLineDash(nfloat, nfloat[])	用於繪製虛線的圖樣。
SetLineDash(nfloat, nfloat[], Int32)	要在其中繪製的圖形內容和基本類型。
SetLineJoin(CGLineJoin)	設定聯結線條的方式。
SetLineWidth(nfloat)	設定筆劃線條的寬度。 此行會延伸一半 w 到路徑的任一端。
SetMiterLimit(nfloat)	指定連接線的 Miter 限制。
SetPatternPhase(CGSize)	在開始並排顯示模式之前，先轉譯模式。
SetRenderingIntent(CGColorRenderingIntent)	如何處理目的地色彩空間以外的色彩。
SetShadow(CGSize, nfloat, CGColor)	要在其中繪製的圖形內容和基本類型。
SetShouldAntialias(Boolean)	與 搭配 SetAllowsAntialiasing(Boolean) 使用，以啟用或停用反鋸齒。
SetShouldSmoothFonts(Boolean)	與 搭配 SetAllowsFontSmoothing(Boolean) 使用，以啟用或停用字型平滑。
SetShouldSubpixelPositionFonts(Boolean)	與 搭配 SetAllowsSubpixelPositioning(Boolean) 使用，以啟用或停用與圖元的字元對齊。
SetStrokeColor(CGColor)	設定筆劃色彩。
SetStrokeColor(nfloat, nfloat)	將筆劃色彩設定為灰階值。
SetStrokeColor(nfloat, nfloat, nfloat, nfloat)	將筆劃色彩設定為 RGBA 色彩。
SetStrokeColor(nfloat, nfloat, nfloat, nfloat, nfloat)	將筆劃色彩設定為 CMYKA 色彩。
SetStrokeColor(nfloat[])	設定筆劃色彩。 如果您未事先設定色彩空間，此 API 會有未定義的行為。
SetStrokeColorSpace(CGColorSpace)	CGColorSpace設定要與 ]) 搭配使用的 。
SetStrokePattern(CGPattern, nfloat[])	設定內容的筆劃模式。
SetTextDrawingMode(CGTextDrawingMode)	指定應該如何轉譯字元。
ShouldSubpixelQuantizeFonts(Boolean)	使用 SetAllowsFontSubpixelQuantization(Boolean) 時，判斷是否應該在子圖元位置繪製字型。
ShowGlyphs(UInt16[])	這個方法已被取代為 N：CoreText。
ShowGlyphs(UInt16[], Int32)	這個方法已被取代為 N：CoreText。
ShowGlyphsAtPoint(nfloat, nfloat, UInt16[])	要在其中繪製的圖形內容和基本類型。
ShowGlyphsAtPoint(nfloat, nfloat, UInt16[], Int32)	要在其中繪製的圖形內容和基本類型。
ShowGlyphsAtPositions(UInt16[], CGPoint[], Int32)	要在其中繪製的圖形內容和基本類型。
ShowGlyphsWithAdvances(UInt16[], CGSize[], Int32)	要在其中繪製的圖形內容和基本類型。
ShowText(Byte[])	這個方法已被取代為 N：CoreText。
ShowText(Byte[], Int32)	這個方法已被取代為 N：CoreText。
ShowText(String)	這個方法已被取代為 N：CoreText。
ShowText(String, Int32)	這個方法已被取代為 N：CoreText。
ShowTextAtPoint(nfloat, nfloat, Byte[])	要在其中繪製的圖形內容和基本類型。
ShowTextAtPoint(nfloat, nfloat, Byte[], Int32)	要在其中繪製的圖形內容和基本類型。
ShowTextAtPoint(nfloat, nfloat, String)	要在其中繪製的圖形內容和基本類型。
ShowTextAtPoint(nfloat, nfloat, String, Int32)	要在其中繪製的圖形內容和基本類型。
StrokeEllipseInRect(CGRect)	筆劃 所 rect 定義的省略號。 之後，會重設目前的路徑。
StrokeLineSegments(CGPoint[])	筆劃 中 points 配對所定義的線條。 之後，會重設目前的路徑。
StrokePath()	筆劃目前的路徑。 之後，會重設目前的路徑。
StrokeRect(CGRect)	筆劃指定的 rect 。 之後，會重設目前的路徑。
StrokeRectWithWidth(CGRect, nfloat)	rect筆劃 。 線條會將 的 width 一半延伸至周邊的任一 rect 端。
Synchronize()	CGContext標示要更新的 。
TranslateCTM(nfloat, nfloat)	變更使用者座標系統的原點。

另請參閱

• avTouch
• Example_Drawing
• 擷皮
• ZoomingPdfViewer