WinProgress Help File

WinProgress Help File

Plugin Name:

WinProgress

Current Version:

1.4.0.0

Description:

WinProgress is an action plugin that with this you can create a system progress object.

Author:

Zloy_Gelud, tavria2

Web:

http://forum.ru-board.com

Requirements:

WinApi Action Plugin Ver: 2.1.0.0


Table of Contents

WinProgress.Create
WinProgress.GetWndHandle
WinProgress.GetCurrentPos
WinProgress.SetCurrentPos
WinProgress.GetRange
WinProgress.SetRange
WinProgress.SetStep
WinProgress.StepIt
WinProgress.GetPos
WinProgress.SetPos
WinProgress.IsVisible
WinProgress.GetSize
WinProgress.SetSize
WinProgress.SetVisible
WinProgress.SetColors

WinProgress.Create


WinProgress.Create ( 

(string) ObjectName,

(boolean) SmoothStyle = true,

(number) Orientation = ORIENT_HORIZONTAL )

Description

Function creates a system progress object using as the container Input object.

Parameters

ObjectName

(string) The name of the input object.

SmoothStyle

(boolean) Use a solid bar to represent the progress.

Orientation

(number) The orientation of the progress bar.

CONSTANT

VALUE

DESCRIPTION

ORIENT_HORIZONTAL

0

Orient the progress bar horizontally. The progress meter will move from left to right.

ORIENT_VERTICAL

1

Orient the progress bar vertically. The progress meter will move from the bottom to the top.

Returns

This action dose not return any value.


WinProgress.GetWndHandle


(number) WinProgress.GetWndHandle ( 

(string) ObjectName )

Description

Returns the numeric window handle of the system progress object.

Parameters

ObjectName

(string) The name of the input object.

Returns

(number) The numeric window handle of the system progress object. If an error occurs -1 is returned.


WinProgress.GetCurrentPos


(number) WinProgress.GetCurrentPos ( 

(string) ObjectName )

Description

Gets the current position of the progress within the progress bar.

Parameters

ObjectName

(string) The name of the input object.

Returns

(number) The current position of the progress meter within the progress bar. If an error occurs -1 is returned.


WinProgress.SetCurrentPos


WinProgress.SetCurrentPos ( 

(string) ObjectName,

(number) Pos )

Description

Sets the position of the progress within the progress bar.

Parameters

ObjectName

(string) The name of the input object.

Pos

(number) The position to set.

Returns

This action dose not return any value.


WinProgress.GetRange


(table) WinProgress.GetRange ( 

(string) ObjectName )

Description

Returns the range of the progress bar in a table.

Parameters

ObjectName

(string) The name of the input object.

Returns

(table) A table containing the range of the progress bar, indexed by values "Begin" and "End". These values can be accessed using the form mytable.Begin and mytable.End. If an error occurs, nil is returned.


WinProgress.SetRange


WinProgress.SetRange ( 

(string) ObjectName,

(number) Begin,

(number) End )

Description

Sets the range of the progress bar.

Parameters

ObjectName

(string) The name of the input object.

Begin

(number) The beginning of the range.

End

(number) The ending of the range.

Returns

This action dose not return any value.


WinProgress.SetStep


WinProgress.SetStep ( 

(string) ObjectName,

(number) Step )

Description

Sets the step value that will be used when WinProgress.StepIt() is called.

Parameters

ObjectName

(string) The name of the input object.

Step

(number) The step value to use.

Returns

This action dose not return any value.


WinProgress.StepIt


WinProgress.StepIt ( 

(string) ObjectName )

Description

Increments the current progress by the step amount specified in the WinProgress.SetStep() action.

Parameters

ObjectName

(string) The name of the input object.

Returns

This action dose not return any value.


WinProgress.GetPos


(table) WinProgress.GetPos ( 

(string) ObjectName )

Description

Returns the X and Y page coordinates of a system progress object in pixels.

Parameters

ObjectName

(string) The name of the input object.

Returns

(table) A table containing the object's current coordinates, indexed by values X and Y. If the object cannot be found, nil will be returned.


WinProgress.SetPos


WinProgress.SetPos ( 

(string) ObjectName,

(number) X,

(number) Y )

Description

Sets the X and Y pixel coordinates of a system progress object relative to the page.

Parameters

ObjectName

(string) The name of the input object.

X

(number) The new X pixel coordinate (horizontal position) to set for the progress object. This is the X coordinate of the upper left hand corner of the object's bounding box relative to the page.

Y

(number) The new Y pixel coordinate (vertical position) to set for the progress object. This is the Y coordinate of the upper left hand corner of the object's bounding box relative to the page.

Returns

This action dose not return any value.


WinProgress.IsVisible


(boolean) WinProgress.IsVisible ( 

(string) ObjectName )

Description

Returns true if a specific system progress object is visible, and false if it isn't.

Parameters

ObjectName

(string) The name of the input object.

Returns

(boolean) True if the system progress object is visible, false if it's invisible. If an error occurs, false will be returned.


WinProgress.GetSize


(table) WinProgress.GetSize ( 

(string) ObjectName )

Description

Returns the pixel dimensions of a system progress object.

Parameters

ObjectName

(string) The name of the input object.

Returns

(table) A table containing the object's pixel dimensions, indexed by values "Width" and "Height". If the object cannot be found, nil will be returned.


WinProgress.SetSize


WinProgress.SetSize ( 

(string) ObjectName,

(number) Width,

(number) Height )

Description

Sets the size of a system progress object.

Parameters

ObjectName

(string) The name of the input object.

Width

(number) The new width of the system progress object.

Height

(number) The new width of the system progress object.

Returns

This action dose not return any value.


WinProgress.SetVisible


WinProgress.SetVisible ( 

(string) ObjectName,

(boolean) Visible = true )

Description

Sets the visibility of a system progress object.

Parameters

ObjectName

(string) The name of the input object.

Visible

(boolean) Whether to make the system progress object visible or invisible.

Returns

This action dose not return any value.


WinProgress.SetColors


WinProgress.SetColors ( 

(string) ObjectName,

(number) BackgroundColor,

(number) BarColor )

Description

Function sets the color of the background and the color of the progress portion of the progress bar to the specified color value.

Note: Use this action only with a solid bar (i.e. SmoothStyle = true).

Parameters

ObjectName

(string) The name of the input object.

BackgroundColor

(number) The color of the background of the progress bar.

BarColor

(number) The color of the progress portion of the progress bar.

Returns

This action dose not return any value.




This File Was Generated With AMS ActionFile Editor