IDCompositionVisual2::SetBackFaceVisibility メソッド (dcomp.h)
3D 変換が適用されたサーフェスをオブザーバーから遠ざけるときに表示するかどうかを指定します。
構文
HRESULT SetBackFaceVisibility(
DCOMPOSITION_BACKFACE_VISIBILITY visibility
);
パラメーター
visibility
[入力]
このビジュアルのサブツリー内のサーフェスを画面に作成するときに使用する背面の可視性。
戻り値
関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。
解説
背面表示プロパティは、3D 変換が適用されたサーフェスのレンダリング方法に影響します。
既定では、ビジュアルは親ビジュアルの背面表示プロパティを継承します。このプロパティは、親ビジュアルの背面表示プロパティを継承する可能性があります。 ビジュアルに対してこのメソッドが呼び出されない場合、またはこのメソッドが DCOMPOSITION_BACKFACE_VISIBILITY_INHERIT で呼び出される場合、ビジュアルはDCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE モードを使用します。 ビジュアルで背面表示プロパティが設定されていない場合、ビジュアル ツリー全体の既定値はDCOMPOSITION_BACKFACE_VISIBILITY_VISIBLE。
visibility パラメーターがDCOMPOSITION_BACKFACE_VISIBILITY_INHERIT以外の場合、このビジュアルのサーフェスは、指定された表示モードで構成されます。 さらに、この表示モードは、現在のビジュアルの子の新しい既定値になります。 つまり、このビジュアルの子の表示モードが変更されていないか、明示的にDCOMPOSITION_BACKFACE_VISIBILITY_INHERITに設定されている場合、子ビジュアルは、このビジュアルの可視性モードを使用して構成されます。
要件
| サポートされている最小のクライアント | Windows 8.1 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dcomp.h |
| Library | Dcomp.lib |
| [DLL] | Dcomp.dll |
関連項目
DirectComposition Backface と D2D Batching