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();

Note

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