POP3it_StatusWindow

Description

This function Shows, Hides, or Moves the Status Window. The first parameter tells POP3it Pro what to do with the StatusWindow. Specify "Show" to Show the StatusWindow, "Hide" to Hide the Status Window, and "Move" to Move the Status Window. If you need to determine if the Status Window is currently visible, you can specify "State" as the first parameter. When Showing or Moving the Status Window, you can specify the Left and Top pixel coordinates for the Status Window. If you specify -1 for either the Left or Top parameter, the Status Window will be centered on that axis. (In other words, if you specified -1 for the Left parameter, POP3it Pro would display the Status Window in the center of the main screen horizontally. If you specify -1 for both Left and Top, POP3it Pro will place the Status Window in the exact center of the main screen.) If you specify 0 for either the Left or Top parameter, POP3it Pro will use the last known position of the Status Window when it was last closed. You can also set a custom Window Title for the Status Window using the final WindowTitle parameter. Note: The Status Window has a Cancel button on it that can be used to cancel lengthy email downloads or imports, so it's a good idea to always show the Status Window when downloading or importing emails.

Return Type

Text

Format

POP3it_StatusWindow ( Action ; Left ; Top ; WindowTitle )

Required Parameters

• Action
  

  Tells POP3it Pro what Action to take with the Status Window. Specify "Show", "Hide", "Move", or "State", the last of which will tell you whether or not the Status Window is currently visible.

Optional Parameters

• Left
  

  Tells POP3it Pro the Left pixel position for the Status Window to be Shown at or Moved to. Specify -1 to center horizontally or 0 to use the last known Left position. The default is 0.

• Top
  

  Tells POP3it Pro the Top pixel position for the Status Window to be Shown at or Moved to. Specify -1 to center vertically or 0 to use the last known Top Position. The default is 0.

• WindowTitle
  

  Specifies a custom Window Title for the Status Window. You can change the Title of the Status Window at any time by using the "Show" Action and specifying the new Window Title.

Examples

Example 1

Code:

POP3it_StatusWindow("Show";-1 ;-1 )

Result:

Displays the Status Window in the center of the main screen.

Example 2

Code:

POP3it_StatusWindow("Hide")

Result:

Hides the Status Window.

Example 3

Code:

POP3it_StatusWindow("State")

Result:

Determines whether or not the Status Window is currently visible.

Example 4

Code:

POP3it_StatusWindow("Move"; 100 ; 100 ;"Downloading Email...")

Result:

Moves the Status Window to the Top, Left corner of the main screen (100 pixels down and 100 pixels to the right), and sets the Window Title to "Downloading Email...".