Cicode Programming Reference > Cicode Function Categories > Trend Functions Introduction > TrendWin

TrendWin

Displays a trend page (in a new window) with the specified trend pens. You need to create the trend page with the graphic builder and set the pen names to blank. You then display that page by calling this function and pass the required trend tags. The function will create a new window with the specified window mode.

Syntax

TrendWin(sPage, X, Y, Mode, sTag1 [, sTag2..sTag8] )

sPage:

The name of the trend page (drawn with the Graphics Builder).

X:

The x pixel coordinate of the top left corner of the window.

Y:

The y pixel coordinate of the top left corner of the window.

Mode:

The mode of the window:

0 - Normal page.

1 - Page child window. The window is closed when a new page is displayed, for example, when the PageDisplay() or PageGoto() function is called. The parent is the current active window.

2 - Window child window. The window is closed automatically when the parent window is freed with the WinFree() function. The parent is the current active window.

4 - No re-size. The window is displayed with thin borders and no maximize/minimize icons. The window cannot be re-sized.

8 - No icons. The window is displayed with thin borders and no maximize/minimize or system menu icons. The window cannot be re-sized.

16 - No caption. The window is displayed with thin borders, no caption, and no maximize/minimize or system menu icons. The window cannot be re-sized.

32 - Echo enabled. When enabled, keyboard echo, prompts, and error messages are displayed on the parent window. This mode should only be used with child windows (for example, Mode 1 and 2).

64 - Always on top.

128 - Open a unique window. This mode helps prevent this window from being opened more then once.

256 - Display the entire window. This mode commands that no parts of the window will appear off the screen

512 - Open a unique Super Genie. This mode helps prevent a Super Genie from being opened more than once (at the same time). However, the same Super Genie with different associations can be opened.

1024 - Disables dynamic resizing of new window, overriding the setting of the [Page]DynamicSizing parameter.

You can select multiple modes by adding modes together (for example, set Mode to 9 to open a page child window without maximize, minimize, or system menu icons).

sTag1:

The firs trend tag to display on the page.

sTag2..sTag8:

The trend tags to display on the page.

Return Value

0 (zero) if successful, otherwise an error is returned.

Related Functions

PageTrend, TrendPopUp, WinNew

Example

Buttons

Text

Trend Window

Command

TrendWin("MyTrend", 0, 0, 4, "PV1", "PV2", "PV3")

Comment

Display a trend page in a new window with no maximize and minimize icons

See Also

Trend Functions