{"id":3524,"date":"2011-10-28T09:20:00","date_gmt":"2011-10-28T17:20:00","guid":{"rendered":"http:\/\/www.sapien.com\/blog\/?p=3524"},"modified":"2011-10-28T09:21:03","modified_gmt":"2011-10-28T17:21:03","slug":"primalforms-2011-spotlight-on-the-tabcontrol","status":"publish","type":"post","link":"https:\/\/dev.sapien.com\/blog\/2011\/10\/28\/primalforms-2011-spotlight-on-the-tabcontrol\/","title":{"rendered":"PrimalForms 2011: Spotlight on the TabControl"},"content":{"rendered":"

The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PrimalForms 2011 , details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms.<\/em><\/p>\n

Last time we took a look at the MaskedTextBox<\/a> control. This time we will look at the TabControl control:<\/p>\n

TabControl <\/strong>[System.Windows.Forms.TabControl]<\/span><\/p>\n

Manages a related set of tab pages.<\/p>\n

\"TabControl\"<\/p>\n

Default Event: SelectedIndexChanged<\/p>\n

Why use a TabControl control?<\/em><\/p>\n

Use the TabControl when you wish to present a series of related controls that are separated into individual pages which can be selected by a tab.<\/p>\n

<\/font><\/span><\/strong><\/p>\n

Important Properties:<\/font><\/span><\/strong><\/p>\n

TabPages<\/strong> <\/p>\n

This property returns the collection of tab pages in this tab control. <\/p>\n

Each tab consists of a TabPage, which acts as a container for other controls that are displayed when the tab is selected. <\/p>\n

TabPage [System.Windows.Forms.TabPage]:<\/p>\n

\n

Important TabPage Properties:<\/p>\n\n\n\n\n\n\n
Property<\/strong><\/td>\nDescription<\/td>\n<\/tr>\n
Text<\/td>\nThe text that is displayed on the Tab.<\/td>\n<\/tr>\n
ToolTipText<\/td>\nThe text that is displayed in a tooltip when the mouse hovers over the tab (See ShowToolTip property for more info).<\/td>\n<\/tr>\n
ImageIndex<\/td>\nSets the image of the tab to the respective image located in the TabControl\u2019s ImageList property.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n<\/blockquote>\n

Example of TabPages used to display a set of controls:<\/p>\n

\"Sample<\/a><\/p>\n

\"Sample<\/a><\/p>\n

In the designer, you can drag and drop controls directly in the TabPage as you would within the form.<\/p>\n

ImageList<\/strong><\/p>\n

This property returns or sets the images to display on the control\u2019s tabs. <\/p>\n

When an ImageList is set you can use the TabPage\u2019s ImageIndex property to select an image to display on the tab:<\/p>\n

\"Tab<\/p>\n

See the PrimalForms 2011: Spotlight of the ImageList Control<\/a> blog article for more details on how to use an ImageList.<\/p>\n

<\/strong> <\/p>\n

SelectedTab<\/strong><\/p>\n

This property returns or sets the currently selected tab page.<\/p>\n

You can use this property to programmatically change the current tab:<\/p>\n

$tabcontrol1<\/span>.SelectedTab <\/span>=<\/span> <\/span>$tabpageProcess<\/span><\/pre>\n
 <\/p>\n
SelectedIndex<\/strong><\/p>\n
This property returns or sets the index of the currently selected tab page. <\/p>\n
SelectedIndex is similar to the SelectedTab but instead it uses the index of the tab to determine which tab is selected. <\/p>\n
$tabcontrol1<\/span>.SelectedIndex <\/span>=<\/span> <\/span>0<\/span> <\/span>#Select the first tab<\/span><\/pre>\n
<\/strong> <\/p>\n
ShowToolTip<\/strong><\/p>\n
This property indicates whether ToolTips should be shown for tabs that have their ToolTips set. Set the ShowToolTip property to True<\/em> to enable ToolTips.<\/p>\n
Default Value: False<\/em><\/p>\n
You must set each TabPage\u2019s ToolTipText property in order for the tooltip to display when the mouse hovers over the tab. <\/p>\n
\"Tab<\/p>\n
<\/strong><\/font> <\/p>\n
Important Events:<\/strong><\/font><\/p>\n
SelectedIndexChanged<\/strong><\/p>\n
This event occurs when the value of the SelectedIndex property changes.<\/p>\n
Use this event if you wish to respond when the current tab is changed. For example, you could use this event to trigger data validation or enable or disable certain controls that depend upon the current tab.<\/p>\n
Note: Pressing Ctrl + Tab will select the next TabPage in the TabControl.<\/p>\n
$tabcontrol1_SelectedIndexChanged<\/span>=<\/span>{\n    \n    <\/span>if<\/span>(<\/span>$tabcontrol1<\/span>.SelectedTab <\/span>-eq<\/span> <\/span>$tabpageProcess<\/span>)\n    {\n        <\/span>#We are on the process tab    <\/span>\n    }\n    <\/span>else<\/span>\n    {\n        <\/span>#We are on another tab    <\/span>\n    }\n    \n}<\/span><\/pre>\n
Another example can be found in the Tab Control Form Template for PrimalForms 2011 which utilizes the SelectedIndexChanged event to the  update navigation buttons:<\/p>\n
$tabcontrol1_SelectedIndexChanged<\/span>=<\/span>{\n    \n    <\/span>$buttonNext<\/span>.Enabled <\/span>=<\/span> <\/span>$tabcontrol1<\/span>.SelectedIndex <\/span>-lt<\/span> <\/span>$tabcontrol1<\/span>.TabCount <\/span>-<\/span> <\/span>1<\/span>    \n    <\/span>$buttonPrev<\/span>.Enabled <\/span>=<\/span> <\/span>$tabcontrol1<\/span>.SelectedIndex <\/span>-gt<\/span> <\/span>0<\/span>\n}<\/span><\/pre>\n
This form template serves as a good starting point when you need a form that requires a TabControl.<\/p>\n","protected":false},"excerpt":{"rendered":"
The \u201cSpotlight on Controls\u201d series focuses on a single WinForms control in PrimalForms 2011 , details the important Properties, Methods, and Events of the control and demonstrates how to utilize the control. Most of the information about the controls is still applicable to previous versions of PrimalForms. Last time we took a look at the […]<\/p>\n","protected":false},"author":10,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_monsterinsights_skip_tracking":false,"_monsterinsights_sitenote_active":false,"_monsterinsights_sitenote_note":"","_monsterinsights_sitenote_category":0,"footnotes":""},"categories":[509,575,644,25],"tags":[641,28,633,689,327],"class_list":["post-3524","post","type-post","status-publish","format-standard","hentry","category-primalforms-software-news","category-primalforms-2011-software-news","category-spotlight-on-controls","category-windows-powershell","tag-controls","tag-powershell","tag-primalforms-2011","tag-tabcontrol","tag-winform"],"jetpack_featured_media_url":"","_links":{"self":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3524","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/users\/10"}],"replies":[{"embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/comments?post=3524"}],"version-history":[{"count":1,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3524\/revisions"}],"predecessor-version":[{"id":3525,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/posts\/3524\/revisions\/3525"}],"wp:attachment":[{"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/media?parent=3524"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/categories?post=3524"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/dev.sapien.com\/blog\/wp-json\/wp\/v2\/tags?post=3524"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}