TabPostEvent PowerScript function

Description

Posts the specified event for each tab page in a Tab control,
adding them to the end of the event queues for the tab page user
objects.

Controls

Tab controls

Syntax

<span>tabcontrolname</span>.<span>TabPostEvent</span> ( <span>event</span> {, <span>word</span>, <span>long</span> } )

1	<span>tabcontrolname</span>.<span>TabPostEvent</span> ( <span>event</span> {, <span>word</span>, <span>long</span> } )

Argument	Description
tabcontrolname	The name of the Tab control for which you want to post events for its tab page user objects.
event	A value of the TrigEvent enumerated datatype that identifies a PowerBuilder event (for example, Clicked!, Modified!, or DoubleClicked!) or a string whose value is the name of an event. The event must be a valid event for a tab page user object in tabcontrolname and a script must exist for the event in tabcontrolname.
word (optional)	A long value to be stored in the WordParm property of the system’s Message object. If you want to specify a value for long, but not word, enter 0. (For cross-platform compatibility, WordParm and LongParm are both longs).
long (optional)	A long value or a string that you want to store in the LongParm property of the system’s Message object. When you specify a string, a pointer to the string is stored in the LongParm property, which you can access with the String function (see Usage for PostEvent).

Return Values

Integer. Returns 1 if it succeeds and
-1 if an error occurs, if the event is not a valid event for the
tab page user object, or if a script does not exist for the event.

Examples

Suppose tab_address contains
several tab pages inherited from uo_list and uo_list has
a user event called ue_display. This
statement posts the event ue_display for
each the tab pages in tab_address:

tab_address.<span>TabPostEvent</span>("ue_display")

1	tab_address.<span>TabPostEvent</span>("ue_display")

August 13, 2023

Was this article helpful?

Connection Information

TabPostEvent – PB Docs 126