IDCompositionRectangleClip::SetLeft(IDCompositionAnimation*) メソッド (dcomp.h)
クリップ四角形の Left プロパティの値をアニメーション化します。 Left プロパティは、クリップ四角形の左上隅の x 座標を指定します。
構文
HRESULT SetLeft(
[in] IDCompositionAnimation *animation
);
パラメーター
[in] animation
Left プロパティの値が時間の経過とともにどのように変化するかを決定するアニメーション オブジェクト。 このパラメーターを NULL にすることはできません。
戻り値
種類: HRESULT
関数が成功した場合は、S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。 エラー コードの一覧については、「 DirectComposition エラー コード 」を参照してください。
注釈
このメソッドは、指定したアニメーションのコピーを作成します。 このメソッドの呼び出し後に アニメーション パラメーターによって参照されるオブジェクトが変更された場合、このメソッドが再度呼び出されない限り、変更は Left プロパティに影響しません。 Left プロパティが以前にアニメーション化されていた場合、このメソッドを呼び出すと、前のアニメーションが新しいアニメーションに置き換えられます。
アニメーションが無効なポインターであるか、影響を受けるビジュアルと同じ IDCompositionDevice インターフェイスによって作成されなかった場合、このメソッドは失敗します。 インターフェイスをカスタム実装にすることはできません。このメソッドでは、Microsoft DirectComposition によって作成されたインターフェイスのみを使用できます。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 8 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | dcomp.h |
| Library | Dcomp.lib |
| [DLL] | Dcomp.dll |