Функция BufferedPaintRenderAnimation (uxtheme.h)

  • Статья

Рисует следующий кадр буферизованной анимации рисования.

Синтаксис

BOOL BufferedPaintRenderAnimation(
  HWND hwnd,
  HDC  hdcTarget
);

Параметры

hwnd

Тип: HWND

Дескриптор к окну, в котором воспроизводится анимация.

hdcTarget

Тип: HDC

Дескриптор целевого контроллера домена, на котором анимируется буфер.

Возвращаемое значение

Тип: BOOL

Возвращает значение TRUE , если кадр был закрашен, или false в противном случае.

Комментарии

Если эта функция возвращает значение TRUE, приложение не должно выполнять дальнейшее рисование. Если эта функция возвращает значение FALSE, приложение должно рисовать в обычном режиме.

Приложение вызывает эту функцию в обработчике WM_PAINT . После того как BufferedPaintRenderAnimation закрашивает кадр анимации, приложение обычно продолжает работу без выполнения обычных операций рисования. При необходимости приложение может выбрать отрисовку дополнительного пользовательского интерфейса в верхней части анимации. В следующем примере кода, который будет включен в больший текст кода, показано, как использовать функции анимации рисования.

    if (!_fBufferedPaintInit)
    {
        BufferedPaintInit();
        _fBufferedPaintInit = TRUE;
    }

    // Determine whether the paint message was generated by a softfade animation.
    if (!BufferedPaintRenderAnimation(hWnd, hdc))
    {
        // Initialize buffered paint parameters.
        BP_ANIMATIONPARAMS animParams = {sizeof(BP_ANIMATIONPARAMS)};
        animParams.style = BPAS_LINEAR; 
        animParams.dwDuration = 0;
        GetThemeTransitionDuration(hTheme, iPartId, iStateIdFrom, 
                iStateIdTo, TMT_TRANSITIONDURATIONS, &animParams.dwDuration);

        HDC hdcFrom, hdcTo;
        HANIMATIONBUFFER hbpAnimation = BeginBufferedAnimation(hWnd, hdc, &rc, 
                BPBF_COMPATIBLEBITMAP, NULL, &animParams, &hdcFrom, &hdcTo);
        if (hbpAnimation)
        {
            if (hdcFrom)
            {
                PaintImpl(hdcFrom, iPartId, iStateIdFrom /*, ...*/);
            }
            if (hdcTo)
            {
                PaintImpl(hdcTo, iPartId, iStateIdTo/*, ...*/);
            }

            EndBufferedAnimation(hbpAnimation, TRUE);
        }
        else
        {
            // Default to unbuffered paint
            PaintImpl(hdc, iPartId, iStateIdTo/*, ...*/);
       
        }
    }
    // Else do not paint because the BufferedPaintRenderAnimation function 
    // already did.
}

Требования

Требование Значение
Минимальная версия клиента Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header uxtheme.h
DLL UxTheme.dll