DrawAnimatedRects function (winuser.h)

Animates the caption of a window to indicate the opening of an icon or the minimizing or maximizing of a window.

Syntax

BOOL DrawAnimatedRects(
  [in] HWND       hwnd,
  [in] int        idAni,
       const RECT *lprcFrom,
       const RECT *lprcTo
);

Parameters

[in] hwnd

A handle to the window whose caption should be animated on the screen. The animation will be clipped to the parent of this window.

[in] idAni

The type of animation. This must be IDANI_CAPTION. With the IDANI_CAPTION animation type, the window caption will animate from the position specified by lprcFrom to the position specified by lprcTo. The effect is similar to minimizing or maximizing a window.

lprcFrom

A pointer to a RECT structure specifying the location and size of the icon or minimized window. Coordinates are relative to the clipping window hwnd.

lprcTo

A pointer to a RECT structure specifying the location and size of the restored window. Coordinates are relative to the clipping window hwnd.

Return value

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Target Platform Windows
Header winuser.h (include Windows.h)
Library User32.lib
DLL User32.dll

See also

Painting and Drawing Functions

Painting and Drawing Overview

RECT