IDCompositionVisual::SetTransformParent メソッド (dcomp.h)

このビジュアルの TransformParent プロパティを設定します。 TransformParent プロパティは、このビジュアルを構成する基準となる座標系を確立します。

構文

HRESULT SetTransformParent(
  [in, optional] IDCompositionVisual *visual
);

パラメーター

[in, optional] visual

型: IDCompositionVisual*

このビジュアルの基本座標系を確立する新しいビジュアル。 このパラメーターは、NULL でもかまいません。

戻り値

型: HRESULT

関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。

注釈

ビジュアルの座標系は、OffsetX、OffsetY、および Transform プロパティによって変更されます。 通常、これらのプロパティは、ビジュアルの直接の親に対する相対座標系を定義します。 このメソッドは、このビジュアルの座標系の基準となるビジュアルの相対位置を指定します。 指定したビジュアルは、現在のビジュアルの先祖である必要があります。 先祖でない場合、座標系は、TransformParent プロパティが NULL に設定されている場合と同様に、このビジュアルの直接の親に基づいています。 ビジュアルは親を変更できるため、指定したビジュアルが親の変更操作によってターゲット ビジュアルの先祖になった場合に、このプロパティを再度有効にすることができます。

visual パラメーターが NULL の場合、座標系は常にビジュアルの直接の親を基準にして変換されます。 このメソッドを使用しない場合の既定の動作です。

visual パラメーターが無効なポインターである場合、またはこの ビジュアル と同じ IDCompositionDevice インターフェイスによって作成されなかった場合、このメソッドは失敗します。 インターフェイスをカスタム実装にすることはできません。このメソッドでは、Microsoft DirectComposition によって作成されたインターフェイスのみを使用できます。

要件

こちらもご覧ください

IDCompositionVisual