IDCompositionVisual::SetBorderMode 方法 (dcomp.h)
設定 BorderMode 屬性,指定如何撰寫與這個視覺效果相關聯之點陣圖和剪輯的邊緣,或與此視覺效果根目錄的子樹狀結構中的視覺效果。
語法
HRESULT SetBorderMode(
[in] DCOMPOSITION_BORDER_MODE borderMode
);
參數
[in] borderMode
要使用的框線模式。
傳回值
類型: HRESULT
如果函式成功,則會傳回S_OK。 否則,它會傳回 HRESULT 錯誤碼。 如需錯誤碼清單,請參閱 DirectComposition 錯誤碼 。
備註
框線模式會影響在轉換點陣圖時,點陣圖邊緣的組成方式,使得邊緣不會完全對齊軸,而且在精確的圖元界限上。 它也會影響內容在具有圓角的裁剪方式,以及轉換的剪輯邊緣,使邊緣不完全對齊軸,以及精確圖元界限。
根據預設,視覺效果會繼承其父視覺效果的框線模式,這可能會繼承其父視覺效果的框線模式等等。 如果從未針對視覺效果呼叫這個方法,或是使用 DCOMPOSITION_BORDER_MODE_INHERIT呼叫此方法,則視覺效果會使用預設框線模式。 如果沒有視覺效果設定框線模式,則整個視覺化樹狀結構的預設值是別名轉譯,可提供最低視覺品質,但效能最高。
如果 borderMode 參數不是 DCOMPOSITION_BORDER_MODE_INHERIT,這個視覺效果的點陣圖和剪輯會以指定的框線模式組成。 此外,這個框線模式會成為目前視覺效果子系的新預設值。 也就是說,如果此視覺效果的子系的框線模式未變更或明確設定為 DCOMPOSITION_BORDER_MODE_INHERIT,則子視覺效果的點陣圖和剪輯會使用此視覺效果的框線模式所組成。
需求
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | dcomp.h |
程式庫 | Dcomp.lib |
Dll | Dcomp.dll |