Image.NineGrid 属性
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
获取或设置九网格隐喻的值,该值控制如何调整图像的大小。 使用九网格比喻,可以拉伸图像的边缘和角,使其与中心不同。 有关详细信息和插图,请参阅“备注”。
public:
property Thickness NineGrid { Thickness get(); void set(Thickness value); };
Thickness NineGrid();
void NineGrid(Thickness value);
public Thickness NineGrid { get; set; }
var thickness = image.nineGrid;
image.nineGrid = thickness;
Public Property NineGrid As Thickness
<Image NineGrid="left,top,right,bottom" />
属性值
一个 Thickness 值,该值设置九网格调整比喻的 左、 上、 右、 下 度量值。
注解
使用九网格渲染时,可以指定图像的不同区域的拉伸方式。 当图像缩放或拉伸时,此功能可用于保留图像角上的详细信息。
九网格呈现将图像划分为九个部分的网格:
使用九网格渲染,可以保留 (框 1、3、7 和 9) 角的原始尺寸。 (框 2 和 8) 的顶部和底部仅水平拉伸, (框 4 和 6) 的边仅垂直拉伸。 中心 (框 5) 在两个维度中拉伸。 若要使用九网格呈现,请创建当图像本身包含嵌入在图像源中的某种类型的边框或边缘修饰时,应用九网格呈现非常有用。 例如,假设你正在使用按钮的图像源,该 按钮 的轮廓是具有透明度的图像的一部分。 你可能希望包含要拉伸的图标的中心区域。 但是,如果拉伸角,可能会从圆角获得别名项目。 或者边框侧可能会变得太厚,在缩放时看起来不太好。 若要防止出现此问题,可以使用具有统一值的 NineGrid,该值始终使边框的像素大小与图像源中的像素大小保持一致。
无论是在代码中还是在 XAML 中,用于设置 NineGrid 属性的 Thickness 的值都是与设备无关的像素值。
下面是使用 NineGrid 值的 Image 元素的示例 XAML:
<Image Source="Images/9grid.bmp" NineGrid="30,20,30,20" />
如果图像没有为 Width 和/或 Height 设置特定值,并且图像被拉伸 (图像呈现到更大的容器空间中,而 Stretch 的值不为 None**) ,则 NineGrid 值仅与图像呈现相关。