| Description | Use this function to show a status window that displays information about what the plug-in is currently doing. When you are transferring a file, the status window will show you what it is currently doing as well as a progress bar indicating how much of the transfer has completed. The data returned from this function includes what action was just taken on the dialog and the coordinates of the window when it closed.
The default placement of the status window is the center of the screen. When the status window closes, the coordinates are automatically saved in the plug-in and used the next time the status window is opened. If the Left and/or Top parameter is specified, these values will take precedence over the values that are in the preferences.
To set a specific start location for the status window, use the Left and/or Top parameters and specify the coordinates in pixels. If you wanted to display it in the top right hand corner of your screen, and your screen resolution is set to 800x600, you could specify left as “700” and top as “100”. If you specify a negative one (“-1”) as either the Left or Top coordinates, the status window will be centered on that axis. For instance, if you want to display it on the bottom of your screen in the center, you would specify Left as “-1” and Top as “600”; or in the center of the screen by specifying Left as “-1” and Top as “-1”.
You can move the Status Window by using “Move” for the Action parameter and the location in pixels that you would like to move it to.
If you need to know if the Status Window is shown or hidden, use “State” as the “Action” parameter. This will return the state as well as the current location of the Status Window.
|
|---|
