PostText

 

Description

 

Initiates a page load using the HTTP POST method, after dismissing from cache any current page with this URL.

 

Arguments

 

Name

Type

I/O

Description

URL

String

In

The URL of the page to be loaded.

TextToPost

String

In

The text to be attached to this POST request.

Hidden

Short Integer

In

When set to zero, the specified page is loaded and displayed normally. When non-zero, the page is loaded hidden from the user.

 

 

 

Return Value

 

Short Integer: zero if load was successfully initiated, else non-zero.

 

 

Remarks

 

If the requested page is in cache, it is dismissed from there and re-loaded.

 

When the Hidden, flag is True the control loads the page without providing any indication to the user that this page load is taking place. The activity and status indicators are unaffected, and the hidden page does not show up in the history list. The container, however, recieves all the usual status change events for the page and can apply all page-related methods to the hidden page.

 

This method is archaic and retained for compatibility with earlier releases. The Navigate method provides a superset of PostText capabilities.