Button Framework in TDL
On this page, you will get all the information about the button related enhancements are done in TallyPrime Release 1.0.
Formatting Attributes
Color
The attribute Color is used to specify the foreground color of the title of the button when the button is in an active state.
Syntax
[Key/Button: <Key/Button Name>]
Color : <Required color>
Example
[Button: TSPLsalesExecutive]
Color : Black
KeyColor
The attribute KeyColor is used to specify the foreground color of the Key of the button when the button is in an active state.
Syntax
[Key/Button: <Key/Button Name>]
KeyColor: <Required color>
Example
[Button: TSPLsalesExecutive]
KeyColor : Blue
InactiveColor
The attribute InactiveColor is used to specify the color of the Key and Title of the button when the button is in an inactive state.
Syntax
[Key/Button : <Key/Button Name>]
InactiveColor : <Required color>
Example
[Button: TSPLsalesExecutive]
InactiveColor : Grey
Background
The attribute Background is used to specify the color of the button when the button is in an inactive state.
Syntax
[Key/Button : <Key/Button Name>]
Background : <Required color>
Example
[Button: TSPLsalesExecutive]
Background : Grey
Style
The attribute Style is used to specify the font-style of the title of the button.
Syntax
[Key/Button : <Key/Button Name>]
Style: <Required font-style>
Example
[Button: TSPLsalesExecutive]
Style : Small
KeyStyle
The attribute KeyStyle is used to specify the font-style of the key of the button.
Syntax
[Key/Button : <Key/Button Name>]
KeyStyle: <Required font-style>
Example
[Button: TSPLsalesExecutive]
KeyStyle : Small Bold
Border
The attribute Border is used to specify the Border for the button.
Syntax
[Key/Button : <Key/Button Name>]
Border: <Required border>
Example
[Button: TSPLsalesExecutive]
KeyStyle : Small Bold
Height
The attribute Height is used to specify the height for the button. This attribute is not applicable for Top and Bottom Toolbar buttons.
Syntax
[Key/Button : <Key/Button Name>]
Height : <Required Height>
Example
[Button: TSPLsalesExecutive]
Height : 5% Screen
Width
The attribute Width is used to specify the width for the button. This attribute is not applicable to the Right Toolbar buttons.
Syntax
[Key/Button : <Key/Button Name>]
Width : <Required Width>
Example
[Button: TSPLsalesExecutive]
Width : 10% Screen
FocusBG
The attribute FocusBG is used to specify the background color of the button when it is focused. This is applicable for Inline Buttons only.
Syntax
[Key/Button : <Key/Button Name>]
FocusBG : <Required Color>
Example
[Button: TSPLsalesExecutive]
FocusBG : Deep Grey
Space Left
The attribute Space Left is used to specify the space to be kept on the left side of the button.
Syntax
[Key/Button : <Key/Button Name>]
Space Left : <Required Space>
Example
[Button: TSPLsalesExecutive]
Space Left : 5% Screen
Space Right
The attribute Space Right is used to specify the space to be kept on the right side of the button.
Syntax
[Key/Button : <Key/Button Name>]
Space Right : <Required Space>
Example
[Button: TSPLsalesExecutive]
Space Right : 5% Screen
Horizontal Align
The attribute Horizontal Align is used to align the contents of the button horizontally.
Syntax
[Key/Button : <Key/Button Name>]
Horizontal Align : < Left / Centre / Right>
Example
[Button: TSPLsalesExecutive]
Horizontal Align : Left
Vertical Align
The attribute Vertical Align is used to align the contents of the button vertically.
Syntax
[Key/Button : <Key/Button Name>]
Vertical Align : < Top / Centre/ Bottom >
Example
[Button: TSPLsalesExecutive]
Vertical Align : Centre
Key Vertical Align
The attribute Key Vertical Align is used to align the Key of the button vertically.
Syntax
[Key/Button : <Key/Button Name>]
Key Vertical Align : < Top / Centre/ Bottom >
Example
[Button: TSPLsalesExecutive]
Vertical Align : Centre
Skip Forward
The attribute Skip Forward is used to Skip the button and move forward. If the key ‘Back Space’ is executed from the consecutive button/field then the focus moves back to this button.
Syntax
[Key/Button : <Key/Button Name>]
Skip Forward : < Logical Value>
Example
[Button: TSPLsalesExecutive]
Skip Forward : Yes
Image
This attribute Image is used to specify the image from the specified resource. The Button will support the image formats like Jpeg, Bitmap, Icon, and Cursor. The resource type in the resource definition can be Bmap, Jpeg, Icon, Cursor.
Syntax
[Key/Button : <Key/Button Name>]
Image : < Logical Value>
Example
[Button: Show Image]
Key : Alt + S
Action : Display : Stock Item Image
Image : Show Image
[Resource: Show Image]
Source : d:\tp\Button\StockItem.jpeg
Resource Type : Jpeg
Line
The attribute Line is used to specify the number of lines for the button. By default, any button has a maximum of 1 line on the display screen. In case more than one line is required to accommodate a content then this attribute is used.
Syntax
[Key/Button : <Key/Button Name>]
Line : < Value>
Example
[Button: TSPLsalesExecutiveSummary]
Title : “Sales Executive wise Summary”
Lines : 2
Inline Button
The buttons that can be placed inside the report are called Inline Buttons. These are declared inside the ‘Part’ definition, with the attribute ‘Button’.
Syntax
[Part : <Part Name>]
Button : <Button Name/ Names>
Example
[Part: TSPLsalesExecutiveSummary]
Button : TSPLsalesExecutive
Horizontal Align
The attribute Horizontal Align specifies the horizontal alignment of the buttons or parts of this part.
Syntax
[Part : <Part Name>]
Horizontal Align : <Left / Center / Right>
Vertical Align
The attribute Vertical Align specifies the vertical alignment of the button.
Syntax
[Part : <Part Name>]
Vertical Alignment : <Top / Center / Bottom>
Modifier Key
The attribute Modifier key helps in merging buttons that perform similar kinds of actions. The keys Alt, Ctrl are used to differentiate with the original key and provides the capability to execute another action. If the user presses any modifier key (Ctrl, Alt), the button gets regenerated to show the corresponding Key and Title.
Syntax
[Key/Button: <Key/Button Name>]
Modified Key : <Button/Key Name>
Example
[Button: TSPLFortnight]
Title : $$LocaleString:”Fortnightly”
Key : F6
Action : Set: SVPeriodicity :”Fortnight”
Modifier Keys : TSPLMonthly, TSPLQuaterly
[Button: TSPLMonthly]
Title : $$LocaleString:”Monthly”
Key : Alt + F6
Action : Set : SVPeriodicity :”Month”
[Button: TSPLQuaterly]
Title : $$LocaleString:”Quaterly”
Key : Ctrl + F6
Action : Set: SVPeriodicity :”3 Month”
Popup Menu
The action Popup Menu prompts a specified menu as a drop down/pop up menu from the Top Toolbar button.
Syntax
[Key/Button: <Key/Button Name>]
Action : Popup Menu : <Name of the Menu>
Example
[Button: TSPL Top Toolbar]
Action : Popup Menu : TSPL Sales Analysis
[Menu: TSPL Sales Analysis]
Title : “Sales Analysis”
Item : @@locSalesAnalysis : Display : SalesAnalysis Report
The menu items can have short cut keys, as mentioned below.
Key : @@ locSalesAnalysis : TSPL SalesAnalysis
[Key: TSPL SalesAnalysis]
Key : Alt + S
Action : Display : SalesAnalysis Report
Further, Popup menus can have sub popup menus. Such Popup menus are called as Nested Popup Menu.
Example
[Menu: TSPL Sales Analysis]
Title : “Sales Analysis”
Item : @@locSalesAnalysis : Display : SalesAnalysis Report
Item : @@locSalesExecutiveAnalysis : Popup Menu : SalesExecutiveAnalysis
[Menu: SalesExecutiveAnalysis]
Title : “Sales Executive wise Sales Analysis”
Item : @@locSalesExecWiseSales : Display : SalesExecWise Sales Report
Item : @@locSalesOurstanding : Display : SalesOutstanding Report
