tabsFrontMost ( tabNames )

Returns a value list of object names of the tabs that are the front most tabs selected.

Average rating: 4.2 (36 votes) Log in to vote

Sean Walsh
SolvEnterprises, LLC
http://www.solventllc.com/

Sample input:

tabsFrontMost ( tabsActive ( LayoutObjectNames ( Get ( FileName ) ; Get ( LayoutName ) ) ) )

Sample output:

See examples below.

Function definition: (Copy & paste into FileMaker's Edit Custom Function window)

Case ( 

	// CONDITIONAL EXIT
	ValueCount ( tabNames ) > 0;

	// SINCE WE PASSED THE TEST CHECK AND SEE IF IT'S THE FRONT MOST TAB FOR IT'S PANEL AND IF IT'S PARENT IS ALSO THE FRONT MOST TAB
	Case (

	// IF THE GIVEN TAB'S NESTED LEVEL EQUALS ITS NESTED FRONT MOST (MEANING ALL OF IT'S PARENTS/GRANDPARENTS ARE ALSO SELECTED) THEN ADD IT TO THE VALUE LIST
	tabsNestedLevel ( GetValue ( tabNames; 1 ) ) = tabsNestedFrontMost ( GetValue ( tabNames; 1 ) ); GetValue ( tabNames; 1 ) & "¶" & tabsFrontMost ( RightValues ( tabNames; ValueCount ( tabNames ) - 1 ) );

	// ELSE KEEP BUILDING THE VALUE LIST
	tabsFrontMost ( RightValues ( tabNames; ValueCount ( tabNames ) - 1 ) ) )

)

/*
tabsFrontMost © 2006-2007 SolvEnterprises, LLC
Developed by: Sean Walsh

FileMaker Pro: 8.5

Depends On:
GetValue, RightValues, tabsFrontMost (self), tabsNestedLevel (custom function ), tabsNestedFrontMost (custom function), ValueCount

Format:
tabsFrontMost ( tabNames )

Parameters:
tabNames - a value list of tab names or layout object names.

Data type returned:
Text (Value List )

Description:
Returns a value list of object names of the tabs that are the front most tabs selected.

Example:
There are five sets of tab panels on a layout.

The 1st set has three tabs: Tab 1 A, Tab 1 B, Tab 1 C
The 2nd set has three tabs: Tab 2 A, Tab 2 B, Tab 2 C
The 3rd set has three tabs: Tab 3 A, Tab 3 B, Tab 3 C, this 3rd set is nested in the tab named 'Tab 2 B.'
The 4th set has three tabs: Tab 4 A, Tab 4 B, Tab 4 C, this 4th set is nested in the tab named 'Tab 2 C.'
The 5th set has three tabs: Tab 5 A, Tab 5 B, Tab 5 C, this 5th set is nested in the tab named 'Tab 4 C.'

Results:
All the following results are called using: tabsFrontMost ( tabsActive ( LayoutObjectNames ( Get ( FileName ) ; Get ( LayoutName ) ) ) )

If tab Panels 1 & 2 are both the front most tabs - returns 'Tab 1 A', and 'Tab 2 A'.
If tab panels 1 B, 2 B, 3 A are all the front most tabs - returns 'Tab 1 B', 'Tab 2 B', and 'Tab 3 A'


*/

Returns a value list of object names of the tabs that are the front most tabs selected. Unlike other tab functions this function will look at tab panels that are side by side.

Example:
There are five sets of tab panels on a layout.

The 1st set has three tabs: Tab 1 A, Tab 1 B, Tab 1 C
The 2nd set has three tabs: Tab 2 A, Tab 2 B, Tab 2 C
The 3rd set has three tabs: Tab 3 A, Tab 3 B, Tab 3 C, this 3rd set is nested in the tab named 'Tab 2 B.'
The 4th set has three tabs: Tab 4 A, Tab 4 B, Tab 4 C, this 4th set is nested in the tab named 'Tab 2 C.'
The 5th set has three tabs: Tab 5 A, Tab 5 B, Tab 5 C, this 5th set is nested in the tab named 'Tab 4 C.'

Results:
All the following results are called using: tabsFrontMost ( tabsActive ( LayoutObjectNames ( Get ( FileName ) ; Get ( LayoutName ) ) ) )

If tab Panels 1 & 2 are both the front most tabs - returns 'Tab 1 A', and 'Tab 2 A'.
If tab panels 1 B, 2 B, 3 A are all the front most tabs - returns 'Tab 1 B', 'Tab 2 B', and 'Tab 3 A'

Comments

		WilliamCB, London Jul 30, 2009
What about the case where Tab 5 B is frontmost?

Note: these functions are not guaranteed or supported by BrianDunning.com. Please contact the individual developer with any questions or problems.

tabsFrontMost ( tabNames )

Comments

Support this website.

Support this website.