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: