setCtlTab

Syntax

int setCtlTab(int n, int t, int s)

Arguments

n
The number of the control to add to a tab sheet
t
The number of the tab to add the control to
s
The number of the tabsheet to add the control to

Return

Returns false if control number n is out of range or not in use, or if t is not a valid tab control. Returns true otherwise.

Description

Assigns a user control to a specific tab control & tab sheet on that control.

Comment

Due to the design of the getCtlTab function, the tab control index number should be 1 or higher. If the tab is control #0, you won't be able to use getCtlTab to retrieve the sheet number the control is on.

Example

%fml
ctl[1]: TAB, Text="page0\npage1", Pos=(250, 5), Size=(200, 100)
ctl[2]: STANDARD, Text="Slider", Pos=(280,*)
ctl[8]: PUSHBUTTON, Text="Move slider to other tab sheet", Pos=(250, 120), Size=(150,*)

OnCtl(n): {
  if (n==8 && e==FME_CLICKED) {
    // If not already on page1, move
    // the slider to page1
    if (getCtlTab(2, 1) != 1) {
      setCtlTab(2, 1, 1);
    }
    else {
      // Move slider back to page0
      setCtlTab(2, 1, 0);
    }
  }
  return false;
}

See Also

getCtlTab, TAB