IDCompositionTarget::SetRoot メソッド (dcomp.h)
ビジュアル オブジェクトをビジュアル ツリーの新しいルート オブジェクトとして設定します。
構文
HRESULT SetRoot(
[in, optional] IDCompositionVisual *visual
);
パラメーター
[in, optional] visual
このビジュアル ツリーの新しいルートであるビジュアル オブジェクト。 このパラメーターは、NULL でもかまいません。
戻り値
型: HRESULT
関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。
注釈
ビジュアルには、単一のビジュアル ツリーのルートまたは別のビジュアルの子を指定できますが、両方を同時に指定することはできません。 visual パラメーターが既に別の ビジュアル ツリーのルートであるか、別のビジュアルの子である場合、このメソッドは失敗します。
visual が NULL の場合、ビジュアル ツリーは空です。 以前に NULL 以外のルート ビジュアルがあった場合、そのビジュアルは、別のビジュアル ツリーのルートとして、または別のビジュアルの子として使用できるようになります。
例
例については、「 単純なビジュアル ツリーを構築する方法」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dcomp.h |
| Library | Dcomp.lib |
| [DLL] | Dcomp.dll |