Editing setCtlTab - FilterMeisterWiki

When saving, enter the following:

  _  __  ____    ####    ___            
 | |/ / |  _ \  #    #  (  _`\          
 | ' /  | |_) | #       | | ) |  ####   
 |  <   |  _ <   ####   | | | ) ##  ##  
 | . \  | |_) |      #  | |_) | ##  ##  
 |_|\_\ |____/  #    #  (____/' ##  ##  
                 ####            ####   
                                   ###

Visit Preferences to set your user name

= 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 ==
<code>
%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;
}
</code>

== See Also ==
((getCtlTab)), ((TAB))

Summary of change:
Add document to category: