ID2D1RenderTarget 介面 (d2d1.h)
表示可以接收繪圖命令的物件。 繼承自 ID2D1RenderTarget 的介面會以不同方式呈現它們收到的繪圖命令。
繼承
ID2D1RenderTarget介面繼承自ID2D1Resource。 ID2D1RenderTarget 也有下列類型的成員：
方法
ID2D1RenderTarget介面具有這些方法。
| ID2D1RenderTarget：：BeginDraw 起始此轉譯目標上的繪圖。 |
| ID2D1RenderTarget：：Clear 將繪圖區域清除為指定的色彩。 (多載 2/3) |
| ID2D1RenderTarget：：Clear 將繪圖區域清除為指定的色彩。 (多載 1/3) |
| ID2D1RenderTarget：：CreateBitmap 建立未初始化的 Direct2D 點陣圖。 |
| ID2D1RenderTarget：：CreateBitmap 從記憶體內部來源資料的指標建立 Direct2D 點陣圖。 |
| ID2D1RenderTarget：：CreateBitmap 從指定的點陣圖建立 ID2D1BitmapBrush。 (多載 2/3) |
| ID2D1RenderTarget：：CreateBitmapBrush 從指定的點陣圖建立 ID2D1BitmapBrush。 (多載 1/3) |
| ID2D1RenderTarget：：CreateBitmapBrush 從指定的點陣圖建立 ID2D1BitmapBrush。 筆刷會針對不透明度和轉換使用預設值。 |
| ID2D1RenderTarget：：CreateBitmapBrush 從指定的點陣圖建立 ID2D1BitmapBrush。 (多載 3/3) |
| ID2D1RenderTarget：：CreateBitmapBrush 從指定的點陣圖建立 ID2D1BitmapBrush。 筆刷會使用其擴充模式、插補模式、不透明度和轉換的預設值。 |
| ID2D1RenderTarget：：CreateBitmapFromWicBitmap 複製指定的 Microsoft Windows 映像處理元件 (WIC) 點陣圖，以建立 ID2D1Bitmap。 (多載 2/4) |
| ID2D1RenderTarget：：CreateBitmapFromWicBitmap 複製指定的 Microsoft Windows 映像處理元件 (WIC) 點陣圖，以建立 ID2D1Bitmap。 (多載 4/4) |
| ID2D1RenderTarget：：CreateBitmapFromWicBitmap 複製指定的 Microsoft Windows 映像處理元件 (WIC) 點陣圖，以建立 ID2D1Bitmap。 (多載 3/4) |
| ID2D1RenderTarget：：CreateCompatibleRenderTarget 建立新的點陣圖轉譯目標，以在與目前轉譯目標相容的中繼螢幕繪圖期間使用。 |
| ID2D1RenderTarget：：CreateCompatibleRenderTarget 建立點陣圖轉譯目標，以在與目前轉譯目標相容的中繼離螢幕繪圖期間使用。 (多載 2/2) |
| ID2D1RenderTarget：：CreateCompatibleRenderTarget 建立點陣圖轉譯目標，以在與目前轉譯目標相容的中繼離螢幕繪圖期間使用。 (多載 1/2) |
| ID2D1RenderTarget：：CreateCompatibleRenderTarget 建立點陣圖轉譯目標，以在與目前轉譯目標相容的中繼螢幕外繪圖期間使用。 新的點陣圖轉譯目標具有與目前轉譯目標相同的像素格式 (，但不是 Alpha 模式) 。 |
| ID2D1RenderTarget：：CreateCompatibleRenderTarget 建立新的點陣圖轉譯目標，以在與目前轉譯目標相容的中繼螢幕繪圖期間使用，且具有與目前轉譯目標相同的像素格式 (，但不是 Alpha 模式) 。 |
| ID2D1RenderTarget：：CreateCompatibleRenderTarget 建立新的點陣圖轉譯目標，以在與目前轉譯目標相容的中繼螢幕繪圖期間使用，且大小、DPI 和像素格式相同 (，但不會) 為目前的轉譯目標。 |
| ID2D1RenderTarget：：CreateGradientStopCollection 從指定的 D2D1_GRADIENT_STOP 結構陣列建立 ID2D1GradientStopCollection。 |
| ID2D1RenderTarget：：CreateGradientStopCollection 從指定的漸層停駐點建立 ID2D1GradientStopCollection，該停駐點會使用D2D1_GAMMA_2_2色彩插補 gamma 和固定擴充模式。 |
| ID2D1RenderTarget：：CreateLayer 建立圖層資源，可與這個轉譯目標及其相容的轉譯目標搭配使用。 (多載 2/2) |
| ID2D1RenderTarget：：CreateLayer 建立圖層資源，可與這個轉譯目標及其相容的轉譯目標搭配使用。 新圖層具有指定的初始大小。 |
| ID2D1RenderTarget：：CreateLayer 建立圖層資源，可與這個轉譯目標及其相容的轉譯目標搭配使用。 (多載 1/2) |
| ID2D1RenderTarget：：CreateLinearGradientBrush 建立 ID2D1LinearGradientBrush，其中包含指定的漸層停駐點，並具有指定的轉換和基底不透明度。 |
| ID2D1RenderTarget：：CreateLinearGradientBrush 建立 ID2D1LinearGradientBrush，其中包含指定的漸層停駐點、沒有轉換，且基底不透明度為 1.0。 |
| ID2D1RenderTarget：：CreateLinearGradientBrush 建立 ID2D1LinearGradientBrush 物件，以繪製具有線性漸層的區域。 |
| ID2D1RenderTarget：：CreateMesh 建立使用三角形來描述圖形的網格。 |
| ID2D1RenderTarget：：CreateRadialGradientBrush 建立 ID2D1RadialGradientBrush，其中包含指定的漸層停駐點，並具有指定的轉換和基底不透明度。 |
| ID2D1RenderTarget：：CreateRadialGradientBrush 建立 ID2D1RadialGradientBrush，其中包含指定的漸層停駐點、沒有轉換，且基底不透明度為 1.0。 |
| ID2D1RenderTarget：：CreateRadialGradientBrush 建立 ID2D1RadialGradientBrush 物件，可用來使用星形漸層繪製區域。 |
| ID2D1RenderTarget：：CreateSharedBitmap 建立 ID2D1Bitmap，其資料會與另一個資源分享。 |
| ID2D1RenderTarget：：CreateSolidColorBrush 建立具有指定色彩和不透明度的新 ID2D1SolidColorBrush。 |
| ID2D1RenderTarget：：CreateSolidColorBrush 建立新的 ID2D1SolidColorBrush，其具有指定的色彩和 1.0f 的基底不透明度。 |
| ID2D1RenderTarget：：CreateSolidColorBrush 建立新的 ID2D1SolidColorBrush，可用來使用純色繪製區域。 |
| ID2D1RenderTarget：:D rawBitmap 將指定的點陣圖縮放至指定矩形的大小之後繪製。 (多載 1/3) |
| ID2D1RenderTarget：:D rawBitmap 將指定的點陣圖縮放至指定矩形的大小之後繪製。 (多載 2/3) |
| ID2D1RenderTarget：:D rawBitmap 將指定的點陣圖縮放至指定矩形的大小之後繪製。 (多載 3/3) |
| ID2D1RenderTarget：:D rawEllipse 使用指定的筆劃樣式繪製指定橢圓形的外框。 |
| ID2D1RenderTarget：:D rawEllipse 使用指定的維度和筆劃繪製橢圓形的外框。 |
| ID2D1RenderTarget：:D rawGeometry 使用指定的筆劃樣式繪製指定幾何的外框。 |
| ID2D1RenderTarget：:D rawGlyphRun 繪製指定的圖像。 |
| ID2D1RenderTarget：:D rawLine 使用指定的筆劃樣式，在指定的點之間繪製線條。 |
| ID2D1RenderTarget：:D rawRectangle 繪製具有指定維度和筆劃樣式之矩形的外框。 (多載 2/2) |
| ID2D1RenderTarget：:D rawRectangle 繪製具有指定維度和筆劃樣式之矩形的外框。 (多載 1/2) |
| ID2D1RenderTarget：:D rawRoundedRectangle 使用指定的筆劃樣式繪製指定圓角矩形的外框。 (多載 1/2) |
| ID2D1RenderTarget：:D rawRoundedRectangle 使用指定的筆劃樣式繪製指定圓角矩形的外框。 (多載 2/2) |
| ID2D1RenderTarget：:D rawText 使用 IDWriteTextFormat 物件所提供的格式資訊繪製指定的文字。 (多載 1/2) |
| ID2D1RenderTarget：:D rawText 使用 IDWriteTextFormat 物件所提供的格式資訊繪製指定的文字。 (多載 2/2) |
| ID2D1RenderTarget：:D rawTextLayout 繪製指定的 IDWriteTextLayout 物件所描述的格式化文字。 |
| ID2D1RenderTarget：：EndDraw 結束轉譯目標上的繪圖作業，並指出目前的錯誤狀態和相關聯的標記。 |
| ID2D1RenderTarget：：FillEllipse 繪製指定橢圓形的內部。 (多載 1/2) |
| ID2D1RenderTarget：：FillEllipse 繪製指定橢圓形的內部。 (多載 2/2) |
| ID2D1RenderTarget：：FillGeometry 繪製指定幾何的內部。 |
| ID2D1RenderTarget：：FillMesh 繪製指定網格的內部。 |
| ID2D1RenderTarget：：FillOpacityMask 將指定點陣圖所描述的不透明度遮罩套用至筆刷，並使用該筆刷繪製轉譯目標的區域。 (多載 1/2) |
| ID2D1RenderTarget：：FillOpacityMask 將指定點陣圖所描述的不透明度遮罩套用至筆刷，並使用該筆刷繪製轉譯目標的區域。 (多載 2/2) |
| ID2D1RenderTarget：：FillRectangle 繪製指定矩形的內部。 (多載 1/2) |
| ID2D1RenderTarget：：FillRectangle 繪製指定矩形的內部。 (多載 2/2) |
| ID2D1RenderTarget：：FillRoundedRectangle 繪製指定圓角矩形的內部。 (多載 1/2) |
| ID2D1RenderTarget：：FillRoundedRectangle 繪製指定圓角矩形的內部。 (多載 2/2) |
| ID2D1RenderTarget：：Flush 執行所有擱置的繪圖命令。 |
| ID2D1RenderTarget：：GetAntialiasMode 擷取非文字繪圖作業的目前反鋸齒模式。 |
| ID2D1RenderTarget：：GetDpi 傳回轉譯目標的每英吋點數 (DPI) 。 |
| ID2D1RenderTarget：：GetMaximumBitmapSize 取得轉譯目標所支援之任何一個點陣圖維度的大小上限，以裝置相依單位 (圖元) 。 |
| ID2D1RenderTarget：：GetPixelFormat 擷取轉譯目標的像素格式和 Alpha 模式。 |
| ID2D1RenderTarget：：GetPixelSize 以裝置圖元傳回轉譯目標的大小。 |
| ID2D1RenderTarget：：GetSize 傳回與裝置無關圖元的轉譯目標大小。 |
| ID2D1RenderTarget：：GetTags 取得後續繪圖作業的標籤。 |
| ID2D1RenderTarget：：GetTextAntialiasMode 取得文字和圖像繪圖作業的目前反鋸齒模式。 |
| ID2D1RenderTarget：：GetTextRenderingParams 擷取轉譯目標的目前文字轉譯選項。 |
| ID2D1RenderTarget：：GetTransform 取得轉譯目標的目前轉換。 |
| ID2D1RenderTarget：：IsSupported 指出轉譯目標是否支援指定的屬性。 (多載 1/2) |
| ID2D1RenderTarget：：IsSupported 指出轉譯目標是否支援指定的屬性。 (多載 2/2) |
| ID2D1RenderTarget：:P opAxisAlignedClip 從轉譯目標移除最後一個軸對齊的剪輯。 呼叫這個方法之後，剪輯就不會再套用至後續的繪圖作業。 |
| ID2D1RenderTarget：:P opLayer 停止將繪圖作業重新導向至最後一個 PushLayer 呼叫所指定的圖層。 |
| ID2D1RenderTarget：:P ushAxisAlignedClip 指定要裁剪所有後續繪圖作業的矩形。 (多載 2/2) |
| ID2D1RenderTarget：:P ushAxisAlignedClip 指定要裁剪所有後續繪圖作業的矩形。 (多載 1/2) |
| ID2D1RenderTarget：:P ushLayer 將指定的圖層加入至轉譯目標，以便接收所有後續的繪圖作業，直到呼叫 PopLayer 為止。 (多載 2/2) |
| ID2D1RenderTarget：:P ushLayer 將指定的圖層加入至轉譯目標，以便接收所有後續的繪圖作業，直到呼叫 PopLayer 為止。 (多載 1/2) |
| ID2D1RenderTarget：：RestoreDrawingState 將轉譯目標的繪圖狀態設定為指定之 ID2D1DrawingStateBlock 的繪圖狀態。 |
| ID2D1RenderTarget：：SaveDrawingState 將目前的繪圖狀態儲存至指定的 ID2D1DrawingStateBlock。 |
| ID2D1RenderTarget：：SetAntialiasMode 設定轉譯目標的反鋸齒模式。 反鋸齒模式適用于所有後續的繪圖作業，不包括文字和圖像繪圖作業。 |
| ID2D1RenderTarget：：SetDpi 設定轉譯目標的每英吋點數 (DPI) 。 |
| ID2D1RenderTarget：：SetTags 指定後續繪圖作業的標籤。 |
| ID2D1RenderTarget：：SetTextAntialiasMode 指定要用於後續文字和圖像繪圖作業的反鋸齒模式。 |
| ID2D1RenderTarget：：SetTextRenderingParams 指定要套用至所有後續文字和圖像繪圖作業的文字轉譯選項。 |
| ID2D1RenderTarget：：SetTransform 將指定的轉換套用至轉譯目標，取代現有的轉換。 所有後續的繪圖作業都會在轉換的空間中發生。 (多載 2/2) |
| ID2D1RenderTarget：：SetTransform 將指定的轉換套用至轉譯目標，取代現有的轉換。 所有後續的繪圖作業都會在轉換的空間中發生。 (多載 1/2) |
備註
您的應用程式應該建立轉譯目標一次，並在應用程式存留期間保留它們，或直到轉譯目標的 EndDraw 方法傳回 D2DERR_RECREATE_TARGET 錯誤為止。 當您收到此錯誤時，您必須重新建立轉譯目標 (及其建立的任何資源) 。
規格需求
| 最低支援的用戶端 | 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | d2d1.h |