Understanding Infragistic controls: Tab Control

Working with the Tab Control is actually pretty simple. You may need two operations to work with a tab control, one for getting the selected page and another for selecting a page.

To retrieve the currently selected page, you can use the get_SelectedTab() method or the SelectedTab property. Both return a tab object whose Text property you can use to retrieve the selected page.

Here is an example:

// [TestComplete JScript]<br />function ITabGetSelected(oTab)<br />{<br />return oTab.SelectedTab.Text;<br />}

You need to make sure that you do not mix up SelectedTab and ActiveTab, since they are two different properties and a tab may be active, but not selected.

To get the list of pages in a tab control you can use the Tabs.Item_2 property, and to select a page, the set_SelectedTab() method.

Below is a simple code sample:

// [TestComplete JScript]<br />function ITabSelect(oTab, sPage)<br />{<br />var iCount = oTab.Tabs.Count;<br />var i, sTab;<br />for(i = 0; i < iCount; i++)<br />{<br />sTab = oTab.Tabs.Item_2(i).Text;<br />if(sTab == sPage)<br />{<br />oTab.set_SelectedTab(oTab.Tabs.Item_2(i));<br />return true;<br />}<br />}<br />Log.Error(“Tab ‘” + sPage + “‘ not found”);<br />return false;<br />}

The above example has some disadvantages. There may be invisible tabs in the Infragistic tab control and this code doesn’t check whether the tab is visible or not. If you try to use this function to select the invisible tab it will return true, but the tab won’t be selected. So, you have to modify the function to check whether the tab is visible and then you can use it.

Also it is very useful to have the ability to select a tab by not only using its full name, but using a part of its name. The example below illustrates the modified function:

// [TestComplete JScript]<br />function ITabSelect(oTab, sPage)<br />{<br />var iCount = oTab.Tabs.Count;<br />var i, sTab;<br />for(i = 0; i < iCount; i++)<br />{<br />sTab = oTab.Tabs.Item_2(i).Text.OleValue;<br />if(oTab.Tabs.Item_2(i).Visible)<br />{<br />Log.Message(“Checking tab ‘” + sTab + “‘”);<br />if(sTab.match(sPage))<br />{<br />oTab.set_SelectedTab(oTab.Tabs.Item_2(i));<br />return true;<br />}<br />}<br />else<br />{<br />Log.Message(“Tab ‘” + sTab + “‘ is invisible, skipped”);<br />}<br />}<br />Log.Error(“Tab ‘” + sPage + “‘ not found”);<br />return false;<br />}

Now, you can select a page even if you don’t know it’s full name. For example, if you have a tab with the “Computers(…)” caption, where “…” is the number of computers and can be any integer (0, 5, 167, etc.). You can call this function as shown below:

ITabSelect(oTab, "Computers")

TestComplete 6 has built-in support for this feature. Click the link below to read more about the TestComplete 6 features:

TestComplete 6 Features