IXpsOMTileBrush：：SetViewbox 方法 (xpsobjectmodel.h)
設定要做為磚影像的來源內容部分。
語法
HRESULT SetViewbox(
[in] const XPS_RECT *viewbox
);
參數
[in] viewbox
描述要作為磚影像之來源內容部分的 XPS_RECT 結構。
傳回值
方法會傳回 HRESULT。 可能的值包括下列資料表中的值，但不限於這些值。 如需此表格中未列出的 XPS 檔 API 傳回值的相關資訊，請參閱 XPS 檔錯誤。
| 傳回碼 | 描述 |
|---|---|
|
此方法已成功。 |
|
viewbox 為 Null。 |
|
檢視框中所述的矩形無效。 |
備註
筆刷的檢視方塊會指定要做為磚影像的來源影像或視覺效果部分。
筆刷檢視框的座標相對於來源內容，因此 (0,0) 指定來源內容的左上角。 對於影像，筆刷檢視方塊所指定的維度是以 1/96「 的單位表示。 來源影像中的對應圖元座標會計算如下：
在下列圖例中，左側影像是來源影像的範例，而右邊則是筆刷的選取檢視框顯示為紅色矩形的來源影像。 在此範例中，作為磚筆刷內容的來源影像部分是紅色矩形內的區域。 筆刷不會使用影像的陰影區域。
如果來源影像解析度是每英吋 96 到 96 點，而影像維度為 96 x 96 圖元， 則 viewbox 參數中的欄位值會是：上述參數值會對應至來源影像，如下所示：
- SourceLeft = 96 * 48 / 96 = 左側 48 圖元
- SourceTop = 96 * 24 / 96 = 頂端 24 圖元
- SourceWidth = 96 * 24 / 96 = 24 圖元寬
- SourceHeight = 96 * 48 / 96 = 48 圖元高
規格需求
| 最低支援的用戶端 | 適用于 Windows Vista 的 Windows 7、Windows Vista SP2 和平臺更新 [傳統型應用程式 |UWP 應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008 [傳統型應用程式 |UWP 應用程式] |
| 目標平台 | Windows |
| 標頭 | xpsobjectmodel.h |