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 创建一个新的位图呈现目标，以便在中间屏幕外绘制期间使用，该目标与当前呈现器目标兼容， (但 alpha 模式) 具有相同的大小、DPI 和像素格式。 |
| ID2D1RenderTarget：：CreateGradientStopCollection 从指定的 D2D1_GRADIENT_STOP 结构数组创建 ID2D1GradientStopCollection。 |
| ID2D1RenderTarget：：CreateGradientStopCollection 从使用D2D1_GAMMA_2_2颜色内插伽玛和固定器扩展模式的指定渐变停止创建 ID2D1GradientStopCollection。 |
| ID2D1RenderTarget：：CreateLayer 创建可以与此呈现目标及其兼容的呈现目标一起使用的层资源。 (重载 2/2) |
| ID2D1RenderTarget：：CreateLayer 创建可以与此呈现目标及其兼容的呈现目标一起使用的层资源。 新层具有指定的初始大小。 |
| ID2D1RenderTarget：：CreateLayer 创建可以与此呈现目标及其兼容的呈现目标一起使用的层资源。 (重载 1/2) |
| ID2D1RenderTarget：：CreateLinearGradientBrush 创建一个 ID2D1LinearGradientBrush，该 ID2D1LinearGradientBrush 包含指定的渐变停止点，并具有指定的转换和基不透明度。 |
| ID2D1RenderTarget：：CreateLinearGradientBrush 创建一个 ID2D1LinearGradientBrush，该 ID2D1LinearGradientBrush 包含指定的渐变停止点，没有转换，并且基本不透明度为 1.0。 |
| ID2D1RenderTarget：：CreateLinearGradientBrush 为具有线性渐变的绘制区域创建 ID2D1LinearGradientBrush 对象。 |
| ID2D1RenderTarget：：CreateMesh 创建使用三角形描述形状的网格。 |
| ID2D1RenderTarget：：CreateRadialGradientBrush 创建一个 ID2D1RadialGradientBrush，该 ID2D1RadialGradientBrush 包含指定的渐变停止点，并具有指定的转换和基不透明度。 |
| ID2D1RenderTarget：：CreateRadialGradientBrush 创建一个 ID2D1RadialGradientBrush，该 ID2D1RadialGradientBrush 包含指定的渐变停止点，没有转换，其基不透明度为 1.0。 |
| ID2D1RenderTarget：：CreateRadialGradientBrush 创建一个 ID2D1RadialGradientBrush 对象，该对象可用于绘制具有径向渐变的区域。 |
| ID2D1RenderTarget：：CreateSharedBitmap 创建一个 ID2D1Bitmap，其数据与其他资源共享。 |
| ID2D1RenderTarget::CreateSolidColorBrush 创建具有指定颜色和不透明度的新 ID2D1SolidColorBrush。 |
| ID2D1RenderTarget::CreateSolidColorBrush 创建具有指定颜色和基不透明度为 1.0f 的新 ID2D1SolidColorBrush。 |
| 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 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用] |
| 最低受支持的服务器 | Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用] |
| 目标平台 | Windows |
| 标头 | d2d1.h |
另请参阅
请参阅 Direct2D API 概述