PPG.CurrentTab

Introduced

v4.0

Description

Returns or sets the current tab visible on the property page as a String. The tab is identified by its label (see PPGLayout.AddTab).

Examples

JScript Example

// Demonstration of the ability to manipulate Tabs on 
// a PPG from within PPG logic code.
//
// It is possible to find out what tab is active,
// change the tab, and to get notified when the tab changes.
// Create a basic Custom PSet that doesn't even have any parameters,
// just layout elements.
var oPSet = ActiveSceneRoot.AddProperty( "CustomProperty",false,"TabDemo" )
var oLayout = oPSet.PPGLayout
oLayout.AddTab( "Tab 1" );
oLayout.AddButton( "Tab1Button", "Next" );
oLayout.AddTab( "Tab 2" );
oLayout.AddButton( "Tab2Button", "Previous" );
oLayout.AddTab( "LeaveMeAlone" ) ;
oLayout.AddButton( "NeverSeen" );
oLayout.Language = "JScript";
oLayout.Logic = OnInit.toString() + 
                Tab1_OnTab.toString() + 
                Tab2_OnTab.toString() + 
                LeaveMeAlone_OnTab.toString() +
                Tab1Button_OnClicked.toString() +
                Tab2Button_OnClicked.toString() ;
InspectObj( oPSet )
//
// The following is the logic code that
// controls the behavior of the PPG.
//
function OnInit()
{
        // Note: Currently it is not possible to change
        // tabs during the OnInit callback              
}
function Tab1Button_OnClicked()
{
        // "Next" button
        PPG.CurrentTab = "Tab 2" ;
}
function Tab2Button_OnClicked()
{
        // Move to the Previous tab
        PPG.CurrentTab = "Tab 1" ;
}
function Tab1_OnTab()
{
        // Called when Tab1 gets clicked
        // and when we first open the PPG.
        // (But not called when we change
        // the tab programmatically.)
        // Notice how the space in the tab label ("Tab 1")
        // has been removed to generate the callback name
        // ("Tab1_OnTab")
        Logmessage( "Current tab is: " + PPG.CurrentTab ) ;     
}
function Tab2_OnTab()
{
        Logmessage( "Now current tab is: " + PPG.CurrentTab ) ;
}
function LeaveMeAlone_OnTab()
{
        // Rather a harsh user interface - 
        // prevent users from going to this
        // tab.  This might be useful when implementing
        // a Wizard-style workflow 
        PPG.CurrentTab = "Tab 1" ;
}

See Also

InspectObj PPG.Inspected