OverlayMBS.AutoCaptureMouse as Boolean
property, Window, MBS REALbasic Overlay Plugin (Overlay), class OverlayMBS, Plugin version: 9.2, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.

Function: Whether the mouse should be captured automatically on Windows.
Notes:
If you return true from MouseDown the mouse is catched. This way you can get the drag events even if the mouse moves out of the window.
On MouseUp the mouse is released.
(Read and Write property)

dim o as OverlayMBS
dim p as Picture

o=new OverlayMBS(100,100,300,300)

p=NewPicture(300,300,32)
p.Graphics.ForeColor=&c000000
p.Graphics.FillRect 0,0,300,300

o.Pict=p

p=NewPicture(300,300,32)
p.Graphics.ForeColor=&c000000
p.Graphics.FillOval 0,0,300,300
p.Graphics.ForeColor=&cFFFFFF
p.Graphics.FillOval 100,100,100,100

o.Mask=p

o.UpdateShow

// wait 5 seconds to see the window
DelayMBS 5

// a dark window with round edges

dim m,p as Picture
static o as OverlayMBS

const rect_width=300
const rect_height=300
const round_rect_int=30

p=NewPicture(rect_width,rect_height,32)
m=NewPicture(rect_width,rect_height,32)

p.Graphics.ForeColor = RGB( 20,20,20 )
p.Graphics.DrawRect 0, 0, rect_width, rect_height
p.Graphics.FillRect  0, 0, rect_width, rect_height

// fill the window mask with around 10% transparency
m.Graphics.ForeColor = RGB( 20,20,20 )
m.Graphics.FillRoundRect 0, 0, rect_width, rect_height, round_rect_int, round_rect_int

// write text into picture
p.Graphics.ForeColor=&cFFFFFF
p.Graphics.DrawString "Hello",10,20

// make the text not transparent
m.Graphics.ForeColor=&c000000
m.Graphics.DrawString "Hello",10,20

o=new OverlayMBS(200,200,rect_width, rect_height, true)
o.Pict=p
o.Mask=m
o.UpdateShow

static o as OverlayMBS // keep the variable global somewhere. Static or part of a module or in app class.

o = new OverlayMBS(100,100,100,100)

o.Pict = LogoMBS(100)
o.mask = LogoMBS(100)

o.Left = 200

o.UpdateShow

static o as OverlayMBS // keep the variable global somewhere. Static or part of a module or in app class.

o = new OverlayMBS(100,100,100,100)

o.Pict = LogoMBS(100)
o.mask = LogoMBS(100)

o.top = 200

o.UpdateShow

dim o as OverlayMBS
// ....
o.visible=true

OverlayMBS.WinAnimateWindow(Flags as integer, Time as integer=200) as boolean
method, Window, MBS REALbasic Overlay Plugin (Overlay), class OverlayMBS, Plugin version: 9.4, Mac OS X: Does nothing, Windows: Works, Linux x86: Does nothing, Feedback.

Function: The AnimateWindow function enables you to produce special effects when showing or hiding windows.
Notes:
There are four types of animation: roll, slide, collapse or expand, and alpha-blended fade.

self: The window to animate. The calling thread must own this window.
Time: Specifies how long it takes to play the animation, in milliseconds. Typically, an animation takes 200 milliseconds to play.
Flags: Specifies the type of animation. This parameter can be one or more of the following values. Note that, by default, these flags take effect when showing a window. To take effect when hiding a window, use AW_HIDE and a bitwiseor operator with the appropriate flags.

AW_SLIDE	= &h040000	Uses slide animation. By default, roll animation is used. This flag is ignored when used with AW_CENTER.
AW_ACTIVATE	= &h020000	Activates the window. Do not use this value with AW_HIDE.
AW_BLEND	= &h080000	Uses a fade effect. This flag can be used only if hwnd is a top-level window.
AW_HIDE	= &h010000	Hides the window. By default, the window is shown.
AW_CENTER	= &h10	Makes the window appear to collapse inward if AW_HIDE is used or expand outward if the AW_HIDE is not used. The various direction flags have no effect.
AW_HOR_POSITIVE	= 1	Animates the window from left to right. This flag can be used with roll or slide animation. It is ignored when used with AW_CENTER or AW_BLEND.
AW_HOR_NEGATIVE	= 2	Animates the window from right to left. This flag can be used with roll or slide animation. It is ignored when used with AW_CENTER or AW_BLEND.
AW_VER_POSITIVE	= 4	Animates the window from top to bottom. This flag can be used with roll or slide animation. It is ignored when used with AW_CENTER or AW_BLEND.
AW_VER_NEGATIVE	= 8	Animates the window from bottom to top. This flag can be used with roll or slide animation. It is ignored when used with AW_CENTER or AW_BLEND.

Return Value:
If the function succeeds, the return value is true.
If the function fails, the return value is false.
The function will fail in the following situations:

• If the window uses the window region. Windows XP: This does not cause the function to fail.
• If the window is already visible and you are trying to show the window.
• If the window is already hidden and you are trying to hide the window.
• If there is no direction specified for the slide or roll animation.
• When trying to animate a child window with AW_BLEND.
• If the thread does not own the window. Note that, in this case, AnimateWindow fails but GetLastError returns ERROR_SUCCESS. To get extended error information, call the GetLastError function.

To show or hide a window without special effects, use Show.
When using slide or roll animation, you must specify the direction. It can be either AW_HOR_POSITIVE, AW_HOR_NEGATIVE, AW_VER_POSITIVE, or AW_VER_NEGATIVE.
You can combine AW_HOR_POSITIVE or AW_HOR_NEGATIVE with AW_VER_POSITIVE or AW_VER_NEGATIVE to animate a window diagonally.
The window procedures for the window and its child windows should handle any WM_PRINT or WM_PRINTCLIENT messages. Dialog boxes, controls, and common controls already handle WM_PRINTCLIENT. The default window procedure already handles WM_PRINT.
If a child window is displayed partially clipped, when it is animated it will have holes where it is clipped.
AnimateWindow supports RTL windows.
Avoid animating a window that has a drop shadow because it produces visually distracting, jerky animations.