.NET でカスタムアニメーション動作を作成および変更

このページの概要

PowerPoint プレゼンテーションで Aspose.Slides for .NET を使用して、カスタムアニメーション動作と編集可能なモーションパスを作成、検査、変更します。

概要

カスタムアニメーション動作を使用すると、色の変更、形状の回転、編集可能なモーションパスの追従など、アニメーション効果内の個々の操作を制御できます。このガイドでは、動作の作成と組み合わせ、タイミングの構成、既存のアニメーションの検査と変更、そしてプロパティがプレゼンテーションの保存と再オープン後も保持されることを確認する方法を示します。

事前定義された効果やクリックトリガーについては、シェイプアニメーションをご参照ください。

アニメーションモデルの理解

アニメーションは Timeline → Sequence → Effect → Behaviors の階層で構成されます。

スライドのTimelineにはメインシーケンスとインタラクティブシーケンスが含まれます。
ISequenceは、対象となる形状が異なる可能性のあるエフェクトを保持します。
IEffectは対象形状、プリセット、サブタイプ、エフェクトタイミングを特定します。
IEffect.Behaviorsには、色の変更、移動、回転、プロパティ設定など、エフェクトを実装する操作が含まれます。

個別の動作の作成

ISequence.AddEffect を呼び出してエフェクトを作成し、その Behaviors コレクションにアクセスします。プリセットはこのコレクションを自動的に構成できます。プリセットを拡張する際はその操作を保持し、意図的に置き換える場合は Clear を使用します。

IBehaviorFactory は下記の 8 種類の動作を作成します。モーションに関してはモーションパスの作成を参照してください。各作成例は完全なプログラムです。後続の編集例は使用する出力ファイルを明記しています。

回転

CreateRotationEffect を使用して回転を作成します。By は度数で相対角度を指定し、From と To は端点を指定します。

この例は Spin エフェクトから開始し、プリセット操作を 1 つの回転動作に置き換え、操作に 2 秒の期間を設定します。90 度の相対角度は形状の開始向きから 1/4 回転を表すため、開始角度を明示的に指定する必要はありません。

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Spin, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var rotation = factory.CreateRotationEffect();
rotation.By = 90f;
rotation.Timing.Duration = 2f;

effect.Behaviors.Add(rotation);

presentation.Save("rotation.pptx", SaveFormat.Pptx);

rotation.pptx には 1 つの形状と 1 つの回転動作が含まれます。以下のコレクション、タイミング、回転編集例はこのファイルを使用します。

拡大縮小

[X/Y パーセンテージ] を用いて CreateScaleEffect を使用します。From と To は開始サイズと終了サイズを表し、By は相対変化を表します。ここで 100 は元のサイズを意味します。

例では両方の寸法を 100% から 125% に 2 秒かけて拡大します。水平・垂直のパーセンテージを同じにすると形状の比率が保たれ、異なるパーセンテージにすると一方がより伸びます。

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.GrowShrink, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var scale = factory.CreateScaleEffect();
scale.From = new PointF(100, 100);
scale.To = new PointF(125, 125);
scale.Timing.Duration = 2f;

effect.Behaviors.Add(scale);

presentation.Save("scale.pptx", SaveFormat.Pptx);

色

CreateColorEffect を使用して塗りを青からオレンジに変更します。From と To は色で、By は色のオフセットです。IBehavior.Properties はアニメーション対象の属性を識別します。

形状の実体塗りは青で初期化され、アニメーションの開始色と一致します。塗りのカラー属性を選択することで、どの部分を変更すべきかが動作に伝わります。保存されたエフェクトは 2 秒でオレンジへ遷移することを記述しています。

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);
shape.FillFormat.FillType = FillType.Solid;
shape.FillFormat.SolidFillColor.Color = Color.Blue;

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.ChangeFillColor, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var color = factory.CreateColorEffect();
color.Properties.Add(BehaviorProperty.FillColor);
color.From.Color = Color.Blue;
color.To.Color = Color.Orange;
color.Timing.Duration = 2f;

effect.Behaviors.Add(color);

presentation.Save("color.pptx", SaveFormat.Pptx);

フィルタ

CreateFilterEffect を使用してワイプを選択します。Type、Subtype、Reveal がフィルタ、方向、表示/非表示を指定します。

この例は右方向のサブタイプで形状を表示する 2 秒のワイプを設定します。フィルタ設定はエフェクト内の動作に属するため、プリセットの元の操作を除去した後に構成します。

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Wipe, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var filter = factory.CreateFilterEffect();
filter.Type = FilterEffectType.Wipe;
filter.Subtype = FilterEffectSubtype.Right;
filter.Reveal = FilterEffectRevealType.In;
filter.Timing.Duration = 2f;

effect.Behaviors.Add(filter);

presentation.Save("filter.pptx", SaveFormat.Pptx);

プロパティ

CreatePropertyEffect を使用して不透明度をアニメーション化します。From、To、By は文字列で、ValueType と CalcMode によって解釈されます。3 つすべてを同時に設定するのではなく、エンドポイントまたは相対オフセットを選択してください。

ここでは属性として不透明度を選択し、数値文字列は 25% の不透明度から完全不透明度への変化を表します。線形補間により、これらの値の間を徐々に変化させます。別の属性に適用する場合は、その属性に適した値タイプとエンドポイント値を選択してください。

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Fade, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var property = factory.CreatePropertyEffect();
property.Properties.Add(BehaviorProperty.StyleOpacity);
property.ValueType = PropertyValueType.Number;
property.CalcMode = PropertyCalcModeType.Linear;
property.From = "0.25";
property.To = "1";
property.Timing.Duration = 2f;

effect.Behaviors.Add(property);

presentation.Save("property.pptx", SaveFormat.Pptx);

設定

CreateSetEffect を使用して To により可視性を設定します。設定動作はエンドポイント間を補間しません。

例では可視性属性を選択し、動作実行時に文字列 visible を割り当てます。最小限のプレゼンテーションでは矩形は既に可視状態のため、単独では目立った変化は見られません。この操作は、形状の表示／非表示を制御する他の効果と組み合わせる際に有用です。

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.Appear, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var set = factory.CreateSetEffect();
set.Properties.Add(BehaviorProperty.StyleVisibility);
set.To = "visible";

effect.Behaviors.Add(set);

presentation.Save("set.pptx", SaveFormat.Pptx);

コマンド

CreateCommandEffect を使用し、Type、CommandString、ShapeTarget を構成します。作業ディレクトリに sample.wav という WAV 録音ファイルを配置してください。この例は AddAudioFrameEmbedded で埋め込み、再生コマンドをオーディオフレームに付加します。

オーディオフレームはエフェクトの対象でもあり、コマンドの対象でもあります。これにより再生要求が埋め込み録音に結び付けられ、コマンド文字列だけではどのメディアオブジェクトを制御するかは特定できません。エフェクトはスライドショー中のクリックで開始するよう構成されています。

using System.IO;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

using var audioStream = File.OpenRead("sample.wav");
var audioFrame = slide.Shapes.AddAudioFrameEmbedded(100, 100, 40, 40, audioStream);

var effect = slide.Timeline.MainSequence.AddEffect(audioFrame, EffectType.MediaPlay, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var command = factory.CreateCommandEffect();
command.Type = CommandEffectType.Call;
command.CommandString = "play";
command.ShapeTarget = audioFrame;

effect.Behaviors.Add(command);

presentation.Save("command.pptx", SaveFormat.Pptx);

保存後は command.pptx にコマンドが格納されますが、録音は再生されません。再生にはコマンドとメディア対象をサポートするスライドショープレーヤーが必要です。

動作コレクションの管理

IBehaviorCollection は Add、Insert、Remove、RemoveAt をサポートします。この例では rotation.pptx を開き、拡大縮小を追加し、回転の前に移動させ、回転を削除します。同一オブジェクトを削除して再挿入するとコピーを作成せずに位置が変更されます。

編集の順序によりコレクションは rotation–scale → scale–rotation → scale の順に変化します。インデックスは現在のコレクションを指すため、再配置後の回転の新しいインデックスで削除が行われます。最終的な列挙で保存される動作が確認できます。

using System;
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("rotation.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];
var behaviors = effect.Behaviors;

IBehaviorFactory factory = new BehaviorFactory();
var scale = factory.CreateScaleEffect();
scale.To = new PointF(125, 125);
scale.Timing.Duration = 2f;

behaviors.Add(scale);

behaviors.Remove(scale);
behaviors.Insert(0, scale);
behaviors.RemoveAt(1);

foreach (var behavior in behaviors)
    Console.WriteLine(behavior.GetType().Name);

presentation.Save("collection-edited.pptx", SaveFormat.Pptx);

出力は ScaleEffect だけです。コレクションの順序自体は動作を順に実行させるスケジュールにはなりません。すべての操作を置き換える場合にのみ Clear を使用してください。

動作タイミングの構成

IBehavior.Timing は ITiming を公開し、IEffect.Timing とは独立しています。エフェクトのタイミングはエフェクト全体のスケジュール、動作のタイミングはその内部の操作を記述します。

期間、遅延、繰り返し、加速の設定

rotation.pptx を開き、Duration と TriggerDelayTime を秒単位で設定し、続いて RepeatCount を構成します。Accelerate と Decelerate は期間の割合で、合計は最大 1 に保ちます。

入力ファイルは回転例で作成したものです。最初の動作が回転であることが分かっています。この例ではその動作のタイミングだけを変更し、90 度の角度はそのままです。角度とタイミングを分離して保持することで、アニメーションを再構築せずにペース調整が容易になります。

using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("rotation.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];

var rotation = (IRotationEffect)effect.Behaviors[0];
rotation.Timing.Duration = 2f;
rotation.Timing.TriggerDelayTime = 0.5f;
rotation.Timing.RepeatCount = 3f;
rotation.Timing.Accelerate = 0.2f;
rotation.Timing.Decelerate = 0.2f;

presentation.Save("timing.pptx", SaveFormat.Pptx);

この動作は 2 秒の期間、0.5 秒の遅延、繰り返し回数 3 を使用します。期間の最初と最後の 20% が加速と減速に割り当てられます。

その他の繰り返しポリシーとして RepeatDuration、RepeatUntilEndSlide、RepeatUntilNextClick があります。すべてを同時に有効にするのではなく、1 つを選択してください。AutoReverse は前方向の再生後に逆方向で再生します。加速・減速は連続的な変化に適用され、離散的な代入やコマンドには適用されません。

モーションパスの作成

CreateMotionEffect を使用してモーションを作成します。From、To、By はパーセンテージベースの座標またはオフセットを示します。編集可能なルートが必要な場合は MotionPath を作成し、IMotionEffect.Path に割り当てます。IMotionPath はパスコマンドを保持します。

MotionCommandPathType が操作を選択します：

コマンド	ポイント数	意味
MoveTo	1	開始位置を設定します。
LineTo	1	直線セグメントの終点まで移動します。
CurveTo	3	2 つの制御点と終点で定義された三次ベジェ曲線に従います。
CloseLoop	0	開始位置に戻ります。
End	0	パスを終了します。

MotionPathPointsType はコーナー点やスムーズ点など、ポイントの編集特性を記述します。コマンドタイプの代替にはなりません。下の曲線例では曲線ポイントタイプを、直線セグメントではコーナーポイントタイプを使用してください。

パス座標はスライド寸法に正規化されます。X の 0.25 移動はスライド幅の 1/4 を意味し、0.25 ポイントではありません。Y は下方向が正です。絶対コマンドはパス座標系で位置を指定し、相対コマンドは現在位置からのオフセットを指定します。これは Origin（パスの基準フレーム選択）や PathEditMode（形状移動時のパス動作制御）とは別です。

直線パスの作成

開始点、1 本の直線セグメント、終了コマンドを持つモーション動作を作成します。IMotionPath.Add はコマンドタイプ、ポイント配列、ポイントタイプ、相対座標フラグを受け取ります。

開始コマンドは (0, 0) を設定し、直線は (0.25, 0) で終わります。これによりスライド幅の 1/4 の水平変位が得られます。終了コマンドには座標ポイントはありません。パスを割り当てた後にモーション動作をエフェクトに追加すると、そのルートが矩形に接続されます。

using System;
using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation();
var slide = presentation.Slides[0];

var shape = slide.Shapes.AddAutoShape(ShapeType.Rectangle, 100, 100, 160, 80);

var effect = slide.Timeline.MainSequence.AddEffect(shape, EffectType.PathRight, EffectSubtype.None, EffectTriggerType.OnClick);
effect.Behaviors.Clear();

IBehaviorFactory factory = new BehaviorFactory();
var motion = factory.CreateMotionEffect();
motion.Origin = MotionOriginType.Layout;
motion.Timing.Duration = 2f;

var path = new MotionPath();
path.Add(MotionCommandPathType.MoveTo, new[] { new PointF(0, 0) }, MotionPathPointsType.Auto, false);
path.Add(MotionCommandPathType.LineTo, new[] { new PointF(0.25f, 0) }, MotionPathPointsType.Corner, false);
path.Add(MotionCommandPathType.End, Array.Empty<PointF>(), MotionPathPointsType.None, false);

motion.Path = path;
effect.Behaviors.Add(motion);

presentation.Save("motion.pptx", SaveFormat.Pptx);

motion.pptx には 3 つのパスコマンドを持つ 1 つのモーション動作が含まれます。以下のファイル編集例はこの構造を前提にしています。

絶対座標と相対座標の比較

以下の 2 つのパスオブジェクトは同一ルートを表します。絶対コマンドは (0.3, 0.1) に終点を持ち、相対コマンドは現在位置 (0.2, 0) に (0.1, 0.1) を加えます。

両パスは同じ開始位置から始まります。相対線の場合は X と Y のオフセットを現在位置に加えて終点を求め、絶対線の場合は直接終点を読み取ります。フラグだけを切り替えて座標を変換しないと別のルートになります。

using System.Drawing;
using Aspose.Slides.Animation;

var absolutePath = new MotionPath();
absolutePath.Add(MotionCommandPathType.MoveTo, new[] { new PointF(0.2f, 0) }, MotionPathPointsType.Auto, false);
absolutePath.Add(MotionCommandPathType.LineTo, new[] { new PointF(0.3f, 0.1f) }, MotionPathPointsType.Corner, false);

var relativePath = new MotionPath();
relativePath.Add(MotionCommandPathType.MoveTo, new[] { new PointF(0.2f, 0) }, MotionPathPointsType.Auto, false);
relativePath.Add(MotionCommandPathType.LineTo, new[] { new PointF(0.1f, 0.1f) }, MotionPathPointsType.Corner, true);

どちらかのパスをモーション動作に割り当ててプレゼンテーションで使用できます。最後の Boolean 引数はそのコマンドに相対座標を使用するかどうかを選択します。

直線を曲線に置き換える

motion.pptx を開き、直線コマンドを三次ベジェ曲線に置き換えます。最初に 2 つの制御点を、続いて終点を指定します。

開始位置は前のコマンドで供給されます。最初の 2 点が曲線の形状を決め、3 点目が目的地となります。コマンドタイプ、ポイント編集タイプ、ポイント配列を同時に更新すると、新しいジオメトリに一致したセグメントになります。

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("motion.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];
var motion = (IMotionEffect)effect.Behaviors[0];

var path = motion.Path;
path[1].CommandType = MotionCommandPathType.CurveTo;
path[1].PointsType = MotionPathPointsType.CurveSmooth;
path[1].Points = new[] { new PointF(0.1f, 0), new PointF(0.2f, 0.1f), new PointF(0.3f, 0.1f) };

presentation.Save("curve.pptx", SaveFormat.Pptx);

curve.pptx のパスは依然として 3 つのコマンドを持ちますが、真ん中のコマンドが曲線に変わっています。

保存されたパスの検査と編集

各 IMotionCmdPath は Points、CommandType、PointsType、IsRelative を公開します。以下の例は motion.pptx にある既知の 3 コマンドパスを使用します。任意の入力の場合は、編集前に対象エフェクトを特定し、コマンドタイプとポイント数をインデックスで確認してください。

コマンドと座標の読み取り

パスを変更せずに読み取ります。終了コマンドとクローズループコマンドにはポイントは不要なので、null のポイント配列を許容します。

出力は各コマンドと相対座標フラグをペアにし、その後にポイントを列挙します。これにより、パスを変更する前にエンドポイントとオフセットを区別できます。曲線は 3 点をリストし、ここにある直線は 1 点だけです。

using System;
using Aspose.Slides;
using Aspose.Slides.Animation;

using var presentation = new Presentation("motion.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];
var motion = (IMotionEffect)effect.Behaviors[0];

var path = motion.Path;
foreach (var segment in path)
{
    Console.WriteLine($"{segment.CommandType}, relative: {segment.IsRelative}");
    if (segment.Points != null)
        foreach (var point in segment.Points)
            Console.WriteLine($"X={point.X}, Y={point.Y}");
}

一覧には開始点、(0.25, 0) で終わる絶対直線、そして終了コマンドが含まれます。

エンドポイントの変更

motion.pptx を開き、直線のポイント配列を置き換えてエンドポイントを移動します。

入力ファイルではインデックス 0 が開始コマンド、インデックス 1 が直線です。直線の単一ポイントを置き換えることで、コマンドタイプ、タイミング、コレクション内の位置を変更せずに目的地を変更できます。コマンドが絶対座標を使用しているため、新しいペアはオフセットではなく位置を表します。

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("motion.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];

var motion = (IMotionEffect)effect.Behaviors[0];
motion.Path[1].Points = new[] { new PointF(0.4f, 0.1f) };

presentation.Save("motion-endpoint.pptx", SaveFormat.Pptx);

motion-endpoint.pptx の直線は (0.4, 0.1) で終わり、元のファイルは変更されていません。

セグメントの置き換え

Insert と RemoveAt を使用して motion.pptx の直線を置き換えます。挿入により古い直線はインデックス 2 にシフトします。

これは既存座標を編集するのではなく、コマンドオブジェクト自体を置き換える例です。挿入後、コレクションは一時的に開始コマンド、新しい直線、古い直線、終了コマンドの 4 つを保持します。インデックス 2 を削除すると古い直線が削除され、新しいルートが残ります。

using System.Drawing;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("motion.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];
var motion = (IMotionEffect)effect.Behaviors[0];

var path = motion.Path;
path.Insert(1, MotionCommandPathType.LineTo, new[] { new PointF(0.2f, 0.1f) }, MotionPathPointsType.Corner, false);
path.RemoveAt(2);

presentation.Save("motion-edited.pptx", SaveFormat.Pptx);

保存されたパスは依然として 3 つのコマンドを持ち、新しい直線は (0.2, 0.1) で終わり、終了コマンドが最後になります。

既存の動作の変更と検証

インデックスが不明な場合はタイプで選択します。この例は rotation.pptx を開き、IRotationEffect を見つけ、角度を変更し、再オープン後に保存された値を確認します。

タイプチェックにより、回転でない動作はループでスキップされます。2 回目のロードは保存されたファイルを別のプレゼンテーションオブジェクトに読み込み、比較はメモリ上の値ではなく永続化されたデータをチェックします。この例は既知のエフェクトがメインシーケンスの最初にあることを前提としていますが、タイプで動作を選択しても任意のプレゼンテーションで正しいエフェクトが見つかる保証はありません。

using System;
using Aspose.Slides;
using Aspose.Slides.Animation;
using Aspose.Slides.Export;

using var presentation = new Presentation("rotation.pptx");
var effect = presentation.Slides[0].Timeline.MainSequence[0];

foreach (var behavior in effect.Behaviors)
{
    if (behavior is IRotationEffect rotation)
        rotation.By = 180f;
}

presentation.Save("rotation-edited.pptx", SaveFormat.Pptx);

using var reopened = new Presentation("rotation-edited.pptx");
var savedEffect = reopened.Slides[0].Timeline.MainSequence[0];

foreach (var behavior in savedEffect.Behaviors)
{
    if (behavior is IRotationEffect rotation)
        Console.WriteLine($"Rotation preserved: {Math.Abs(rotation.By - 180f) < 0.001f}");
}

出力は Rotation preserved: True です。同様のタイプチェックパターンを他の動作にも適用してください。完全な保存確認のためは、対象形状、エフェクト、動作タイプと順序、タイミング、パスコマンドを比較し、浮動小数点値には数値許容誤差を使用します。アニメーションレイアウトが不明なプレゼンテーションについては、シェイプアニメーションの読み取りを参照し、メインおよびインタラクティブシーケンスの走査方法を確認してください。

動作の順序、プリセット、再生

IBehaviorCollection の順序はエフェクトの操作の保存順序です。これは自動的に前の動作を待つプレイリストではありません。タイミングとエフェクト自体がスケジューリングを決定します。動作は重なることがあり、同一プロパティへの操作は Additive や Accumulate を介して相互作用します。「移動 → 回転」のように単にコレクション順序を変更してスケジュールしようとしないでください。明示的なタイミングまたは別々のエフェクトを使用してください（シェイプアニメーションを参照）。

エフェクトの Type と Subtype はプリセットを記述しますが、編集された動作ツリーの完全な説明ではありません。カスタマイズする前にプリセットとサブタイプを選択してください。プリセットを変更するとコレクションが再構築され、カスタム操作が失われる可能性があります。たとえば、カスタマイズされた Spin エフェクトを Fade に変更すると、回転動作が設定およびフィルタ動作に置き換えられます。プリセットやサブタイプを変更した後はコレクションを再度確認してください。プリセットの可視性や初期化操作を削除すると、プリセットが必要とする操作が失われることがあります。例では可視形状を使用し、動作を置き換えているため、すべてのプリセット実装を再構築しているわけではありません。

形式互換性

保存された動作ツリーがすべてのビューアやエクスポートレンダラで同一の再生を保証するわけではありません。保存データとレンダリング結果を別々に確認してください。

形式または出力	確認項目
PPTX	例の主要形式として使用します。再オープンして編集可能な動作ツリーを確認し、対象の PowerPoint バージョンで再生を確認してください。
PPT	従来のバイナリ表現は PPTX と異なる場合があります。別途保存‑再オープンサイクルと再生をテストし、PPTX の成功だけですべてのカスタム組み合わせがサポートされるとは判断しないでください。
PDF、PNG、JPEG などの静的スライド画像	静的なスライド表現であり、再生可能な動作タイムラインや最終アニメーションフレームは保証されません。
HTML5	エクスポートオプションでシェイプアニメーションを有効にすれば、サポートされたアニメーションを再生できます。ブラウザでカスタム組み合わせをテストしてください。
Animated GIF	レンダリングされたフレームを保存しますが、編集可能な動作やクリックトリガーのインタラクションは含まれません。実際のレンダリングされた動きを確認してください。
Video	アニメーションフレームをレンダリングしてビデオとしてエンコードします。サポートはレンダラのサポートされるアニメーションとエフェクトに限定され、コマンドやインタラクティブイベントは編集可能なタイムラインにはなりません。

FAQ

なぜエフェクトに動作が既に含まれているのですか？

事前定義されたエフェクトを作成すると、その基礎となる操作が生成されることがあります。拡張するか置き換えるかを決める前にそれらを検査してください。

動作を先頭に移動すれば最初に再生されますか？

必ずしもそうではありません。コレクション順序はタイミングの代替にはなりません。遅延、期間、同一プロパティへの操作間の相互作用を確認してください。

終了コマンドにポイントがないのはなぜですか？

パスの終了を示すためのもので、座標は不要です。ファイルから読み取ったパスを検査する際は、ポイント配列が null であることをチェックしてください。

往復保存だけで再生が確認できますか？

いいえ。再オープンはチェックしたプロパティの保持を確認しますが、スライドショープレーヤーやアニメーションエクスポートで実際の視覚的動作を別途テストする必要があります。

.NET で PowerPoint プレゼンテーションをアニメーションで強化 .NET を使用したプレゼンテーションでの 3D 効果の作成

.NET でカスタム アニメーション 動作を作成および変更