TabbedBar control

Currently the TabbedBar control is only used to implement the tabbed bar in the MDI/MDIHelp window.

If you have enabled TabbedView for an MDI window, PowerBuilder will automatically add a tabbed bar control to the window and allow you to access some properties of the tabbed bar control. For which properties are accessible, please refer to the section called “Displaying sheets in tabbed view” in Application Techniques.

Please do not add the TabbedBar control manually or call its function/event/property in your application, except the properties listed in the above link.

Properties

TabbedBar property

Datatype

Description

AccessibleDescription

String

This property is currently unsupported.

AccessibleName

String

This property is currently unsupported.

AccessibleRole

AccessibleRole (enumerated)

This property is currently unsupported.

AutosizeHeight

Boolean

This property is currently unsupported.

BringToTop

Boolean

This property is currently unsupported.

ClassDefinition

PowerObject

An object of type PowerObject containing information about the class definition of the object or control.

DragAuto

Boolean

This property is currently unsupported.

DragIcon

String

This property is currently unsupported.

FaceName

String

Specifies the font name for the text shown in the tab header. Default is Tahoma.

FontCharSet

FontCharSet (enumerated)

This property is currently unsupported.

FontFamily

FontFamily (enumerated)

This property is currently unsupported.

FontPitch

FontPitch (enumerated)

This property is currently unsupported.

Height

Integer

Currently, you can only get this property value but cannot set it for the tabbed view in MDI/MDIHelp window.

Specifies the height of the control, in PowerBuilder units.

Italic

Boolean

This property is currently unsupported.

NewTabAtRightMost

Boolean

Specifies whether to open the new tab from the right most location of the bar. Values are:

TRUE -- (Default) Opens the new tab from the right most location of the bar.

FALSE -- Opens the new tab from the left most location of the bar.

ShowCloseButton

Boolean

Specifies whether to show the close button in the tab header. Values are:

TRUE -- (Default) The close button is shown in the tab header.

FALSE -- The close button is not shown in the tab header.

ShowContextMenu

Boolean

Specifies whether to display the popup menu when the right mouse button is clicked on the tab header. Values are:

TRUE -- (Default) The popup menu is shown.

FALSE -- The popup menu is not shown.

ShowIcon

Boolean

Specifies whether to show the window icon in the tab header. Values are:

TRUE -- (Default) The window icon is shown.

FALSE -- The window icon is not shown.

ShowPowerTips

Boolean

Specifies whether to show a PowerTip when the user moves a cursor over the tab header. Values are:

TRUE -- (Default) The PowerTip is shown.

FALSE -- The PowerTip is not shown.

ShowSeparator

Boolean

Specifies whether to show the separator symbol between the tab headers. Values are:

TRUE -- (Default) The separator symbol is shown.

FALSE -- The separator symbol is not shown.

ShowText

Boolean

Specifies whether to show the window title in the tab header. Values are:

TRUE -- (Default) The window title is shown.

FALSE -- The window title is not shown.

TabOrder

Integer

This property is currently unsupported.

Tag

String

This property is currently unsupported.

TextSize

Integer

The font size of the text in the tab header, in points. For backward compatibility, the size is stored as a negative number; for example, 15-point text size is stored as -15.

When the font size is changed and the AutosizeHeight property is true, the height of the tabbed bar is automatically adjusted to the best size, therefore, you can adjust the font size to adjust the bar height. The Code Example App included in the product contains code examples for this.

Transparency

Integer

This property is currently unsupported.

Underline

Boolean

This property is currently unsupported.

Visible

Boolean

Currently, you can only get this property value but cannot set it for the tabbed view in MDI/MDIHelp window.

Specifies whether the control is visible. Values are:

TRUE -- Is visible.

FALSE -- Is not visible.

Weight

Integer

This property is currently unsupported.

Width

Integer

Currently, you can only get this property value but cannot set it for the tabbed view in MDI/MDIHelp window.

Specifies the width of the control, in PowerBuilder units.

X

Integer

Currently, you can only get this property value but cannot set it for the tabbed view in MDI/MDIHelp window.

Specifies the X position (the distance from the left edge of the window), in PowerBuilder units.

Y

Integer

Currently, you can only get this property value but cannot set it for the tabbed view in MDI/MDIHelp window.

Specifies the Y position (the distance from the top of the window), in PowerBuilder units.


Events

This control has no associated events currently.

Functions

TabbedBar function

Datatype returned

Description

ClassName

String

Returns the name assigned to the control.

GetContextService

Integer

Creates a reference to a context-specific instance of the specified service.

GetParent

PowerObject

Returns a reference to the parent of the control.

Hide

Integer

Makes the control invisible.

Move

Integer

This function is currently unsupported.

PostEvent

Integer

This function is currently unsupported.

Resize

Integer

This function is currently unsupported.

SetRedraw

Integer

This function is currently unsupported.

Show

Integer

Makes the control visible.

TriggerEvent

Integer

This function is currently unsupported.

TypeOf

Object

Returns the type of the control.