建立動畫變數

  • 發行項

應用程式必須為每個使用 Windows 動畫產生動畫效果的視覺特性建立動畫變數。

概觀

動畫變數是使用動畫管理員建立的，而且應用程式應該視需要保留每個變數的參考。 您的應用程式通常會與動畫的視覺物件同時建立每個動畫變數。

建立動畫變數時，必須指定其初始值。 之後，其值只能藉由排程產生動畫效果的分鏡腳本來改變。

建構分鏡腳本時，動畫變數會當做參數傳遞，因此應用程式不應該釋放它們，直到它們代表的視覺特性不再需要動畫，通常當相關聯的視覺物件即將終結時。

範例程式碼

動畫色彩

下列範例程式碼取自 Windows 動畫範例 Application-Driven Animation 和 Timer-Driven Animation中的 MainWindow.cpp。 在此範例中，會使用 CreateAnimationVariable 建立三個動畫變數來代表背景色彩。 程式碼也會使用 SetLowerBound 和 SetUpperBound 方法來控制動畫變數的值。

const DOUBLE INITIAL_RED = COLOR_MAX;
const DOUBLE INITIAL_GREEN = COLOR_MAX;
const DOUBLE INITIAL_BLUE = COLOR_MAX;

HRESULT hr = m_pAnimationManager->CreateAnimationVariable(
    INITIAL_RED,
    &m_pAnimationVariableRed
    );
if (SUCCEEDED(hr))
{
    hr = m_pAnimationVariableRed->SetLowerBound(COLOR_MIN);
    if (SUCCEEDED(hr))
    {
        hr = m_pAnimationVariableRed->SetUpperBound(COLOR_MAX);
        if (SUCCEEDED(hr))
        {
            hr = m_pAnimationManager->CreateAnimationVariable(
                INITIAL_GREEN,
                &m_pAnimationVariableGreen
                );
            if (SUCCEEDED(hr))
            {
                hr = m_pAnimationVariableGreen->SetLowerBound(COLOR_MIN);
                if (SUCCEEDED(hr))
                {
                    hr = m_pAnimationVariableGreen->SetUpperBound(COLOR_MAX);
                    if (SUCCEEDED(hr))
                    {
                        hr = m_pAnimationManager->CreateAnimationVariable(
                            INITIAL_BLUE,
                            &m_pAnimationVariableBlue
                            );
                        if (SUCCEEDED(hr))
                        {
                            hr = m_pAnimationVariableBlue->SetLowerBound(COLOR_MIN);
                            if (SUCCEEDED(hr))
                            {
                                hr = m_pAnimationVariableBlue->SetUpperBound(COLOR_MAX);
                            }
                        }
                    }
                }
            }
        }
    }
}

請注意下列來自 MainWindow.h 的定義。

class CMainWindow
{

    ...

private:

    // Animated Variables

    IUIAnimationVariable *m_pAnimationVariableRed;
    IUIAnimationVariable *m_pAnimationVariableGreen;
    IUIAnimationVariable *m_pAnimationVariableBlue;

    ...

};

建立 x 和 y 座標的動畫

下列範例程式碼取自 Windows 動畫 方格版面配置範例中的 Thumbnail.cpp;請參閱 CMainWindow：：CreateAnimationVariables 方法。 系統會建立兩個動畫變數來代表每個物件的 X 和 Y 座標。

// Create the animation variables for the x and y coordinates

hr = m_pAnimationManager->CreateAnimationVariable(
    xInitial,
    &m_pAnimationVariableX
    );

if (SUCCEEDED(hr))
{
    hr = m_pAnimationManager->CreateAnimationVariable(
        yInitial,
        &m_pAnimationVariableY
        );

    ...

}

請注意來自 Thumbnail.h 的下列定義。

class CThumbnail
{
public:

    ...

    // X and Y Animation Variables

    IUIAnimationVariable *m_pAnimationVariableX;
    IUIAnimationVariable *m_pAnimationVariableY;

    ...

};

動畫變數是浮點數，但其值也可以擷取為整數。 根據預設，每個值都會四捨五入為最接近的整數，但可以覆寫用於變數的進位模式。 下列範例程式碼會使用 SetRoundingMode 方法來指定應該一律舍入值。

hr = m_pAnimationVariableX->SetRoundingMode(
    UI_ANIMATION_ROUNDING_MODE_FLOOR
    );
if (SUCCEEDED(hr))
{
    hr = m_pAnimationVariableY->SetRoundingMode(
        UI_ANIMATION_ROUNDING_MODE_FLOOR
        );

    ...

}

上一個步驟

開始此步驟之前，您應該已完成此步驟： 建立主要動畫物件。

後續步驟

完成此步驟之後，下一個步驟是： 更新動畫管理員和繪製畫面格。

IUIAnimationManager：：CreateAnimationVariable

IUIAnimationVariable：：SetLowerBound

IUIAnimationVariable：：SetRoundingMode

IUIAnimationVariable：：SetUpperBound

Windows 動畫概觀