IAgentCharacterEx::GetAnimationNames

[Microsoft エージェントは Windows 7 の時点で非推奨となり、以降のバージョンの Windows では使用できない場合があります。]

HRESULT GetAnimationNames(
   IUnknown ** punkEnum // address of IUnknown interface
);

文字のアニメーション名を取得します。

• 操作が成功したことを示すS_OKを返します。

Iunknown

キャラクターのアニメーション コレクションの IUnknown インターフェイスのアドレス。

この関数を使用すると、文字のアニメーションの名前を列挙できます。 コレクション内のアイテムにはプロパティがないため、個々のアイテムに直接アクセスすることはできません。 コレクションにアクセスするには、IEnumVARIANT インターフェイスの punkEnum に対してクエリを実行します。

IEnumVARIANT pEnum;
VARIANT vAnimName;
DWORD dwRetrieved;

hRes = punkEnum->QueryInterface(IID_IEnumVARIANT, (LPVOID *)&pEnum);

if (SUCCEEDED(hRes)) {

    while (TRUE) {

         hRes = pEnum->Next(1, &vAnimName, &dwRetrieved);

         if (hRes != NOERROR)
            break;

         // vAnimName.bstrVal is the animation name

         VariantClear(&vAnimName);
    } 

    pEnum->Release();
}

punkEnum->Release();

注意

ACF 文字の場合、コレクションは、その文字に対して定義されているすべてのアニメーションを返し、 Get メソッドを使用して取得したアニメーションにを追加します。