ph_openiewindow PowerHome formula function
Description
Allows the user to open a specialized window object consisting of an Internet Explorer control. Full control of this window is available by sending Windows messages.
Syntax
ph_openiewindow ( title, url, flags, x, y, width, height, timeout )
| Argument |
Description |
|
title
|
String. The Title you wish to appear on the IE window.
|
|
url
|
String. The URL you wish to be opened in the Internet Explorer window control. You can use the system variable [HANDLE] to have the handle of the IE Wndow substituted within the URL.
|
|
flags
|
Integer. Individual flag values summed together to control how the window appears. The individual flag values are: 1 to suppress the Title bar. 2 to make the Window not resizeable. 4 to remove the Control menu. 8 to remove the minimize box. 16 to remove the maximize box. 32 to suppress the display of the countdown timer if a timeout value is passed. 64 to suppress scrollbars. 128 to have the IE Window NOT be a child window of the PowerHome environment. 256 to have the window open maximized.
|
|
x
|
Integer. The X location you wish the IE Window to appear. Use - 1 to have the window centered horizontally.
|
|
y
|
Integer. The Y location you wish the IE Window to appear. Use - 1 to have the window centered vertically.
|
|
width
|
Integer. The width of the IE Window. Use - 1 to set the width of the window to the screen width.
|
|
height
|
Integer. The height of the IE Window. Use - 1 to set the height of the window to the screen height.
|
|
timeout
|
Integer. The time in seconds for the IE Window to remain open. Use 0 if you don't wish the window to timeout and close automatically.
|
Return value
Unsigned Long. Returns the handle of the new IE Window. Using this handle, Windows Messages can be sent to remotely control aspects of the window.
Usage
You can use this function to create highly configurable user display windows to also control aspects of PowerHome if the URL contains control code to manipulate the PH environment.