ID2D1BitmapBrush::SetExtendModeY 方法 (d2d1.h)

指定画笔如何垂直平铺超出其位图的区域。

语法

void SetExtendModeY(
  D2D1_EXTEND_MODE extendModeY
);

参数

extendModeY

类型: D2D1_EXTEND_MODE

一个 值,该值指定画笔如何垂直平铺那些超出其位图的区域。

返回值

备注

有时,位图画笔的位图不会完全填满要绘制的区域。 发生这种情况时,Direct2D 使用画笔的水平 (SetExtendModeX) 和垂直 (SetExtendModeY) 扩展模式设置来确定如何填充剩余区域。

下图显示了 ID2D1BitmapBrush 扩展模式的每个可能组合的结果: D2D1_EXTEND_MODE_CLAMP ( CLAMP) 、 D2D1_EXTEND_MODE_WRAP (WRAP) 和 D2D1_EXTEND_MIRROR (MIRROR) 。

来自各种扩展模式的位图和生成的图像的插图

示例

以下示例演示如何将位图画笔的 x 和 y 扩展模式设置为 D2D1_EXTEND_MIRROR。 然后,它使用 ID2D1BitmapBrush 绘制矩形。

它生成以下输出。

将 x 和 y 扩展模式设置为 镜像
m_pBitmapBrush->SetExtendModeX(D2D1_EXTEND_MODE_MIRROR);
m_pBitmapBrush->SetExtendModeY(D2D1_EXTEND_MODE_MIRROR);

m_pRenderTarget->FillRectangle(exampleRectangle, m_pBitmapBrush);

有关位图画笔的详细信息,请参阅 画笔概述

要求

要求
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和适用于 Windows Server 2008 的平台更新 [桌面应用 |UWP 应用]
目标平台 Windows
标头 d2d1.h
Library D2d1.lib
DLL D2d1.dll

另请参阅

ID2D1BitmapBrush

ID2D1BitmapBrush::GetExtendModeY