IXpsOMTileBrush：：GetViewbox 方法 (xpsobjectmodel.h)

取得圖格所要使用的來源影像部分。

語法

HRESULT GetViewbox(
  [out, retval] XPS_RECT *viewbox
);

[out, retval] viewbox

描述磚所要使用的來源內容區域XPS_RECT結構。

如果方法成功，則會傳回S_OK;否則，它會傳回 HRESULT 錯誤碼。

傳回碼	描述
S_OK	此方法已成功。
E_POINTER	viewbox 為 NULL。

筆刷的檢視方塊會指定要做為磚影像的來源影像或視覺效果部分。

筆刷檢視框的座標相對於來源內容，因此 (0,0) 指定來源內容的左上角。對於影像，筆刷檢視方塊所指定的維度是以 1/96“ 的單位表示。來源影像中的對應圖元座標會計算如下：

在下圖中，左側影像是來源影像的範例、中央的影像會顯示選取的檢視框，右邊的影像會顯示產生的筆刷。

如果來源影像解析度是每英吋 96 到 96 點，而影像維度為 96 x 96 像素， 則 viewbox 參數中的欄位值會是：

上述參數值會對應至來源影像，如下所示：

SourceLeft = 96 × 48 / 96 = 左側 48 像素

SourceTop = 96 × 4 / 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