When testing MFC Toolbar controls, you can use specific properties of the corresponding test object as well as properties that TestComplete applies to all test and onscreen objects. All of these properties are listed below. The properties are organized into categories: Standard, Extended, RTTI, Debug Agent and others. For more information about this, see Categories of Object Methods and Properties.
Property List | View ↓
Name | Description |
---|---|
_NewEnum
|
Returns an enumerator for the collection of children that belong to the object. |
ChildCount
|
Returns the number of child objects of the given object. |
ControlId |
Specifies the control identifier of the window. |
Enabled |
Specifies whether an object can accept user input or not. |
Exists
|
Tells you whether an object exists in the system. |
Focused |
Specifies whether the control has input focus. |
FullName
|
Specifies the full name that uniquely identifies the object in TestComplete. |
Handle |
Returns the control’s handle (HWND). |
Height |
Specifies the height of the object in pixels. |
HScroll |
Returns a ScrollBar object that provides a scripting interface to the control’s horizontal scroll bar. |
Id
|
Returns the object’s identifier. |
Index |
Specifies the front-to-back position of the control among other controls that have the same class name and caption, and belong to the same parent window. |
Left |
Specifies the horizontal position of the object’s left edge relative its parent window. |
MappedName
|
Returns the custom name that is mapped to the original object name and is used to address the object in scripts. |
Name
|
Returns the object name. |
NamedChild
|
Returns a child object stored in the Name Mapping repository (by its index). |
NamedChildCount
|
Returns the number of child objects of an object stored in the Name Mapping repository. |
NodeDescription
|
Returns the description of an object stored in the Name Mapping repository. |
Parent
|
Returns the parent object of the given object. |
PopupMenu |
Returns a Menu object that provides a scripting interface to the control’s context menu (the menu must be opened on screen first). |
ScreenLeft |
Specifies the horizontal position of the object’s left edge in screen coordinates. |
ScreenTop |
Specifies the vertical position of the object’s top edge in screen coordinates. |
Top |
Specifies the vertical position of the object’s top edge relative to the object’s parent window. |
Unicode |
Specifies whether the control is a native Unicode window. |
Visible |
Specifies whether the object is visible to users. |
VisibleOnScreen |
Specifies whether any part of the object is currently visible on screen. |
VScroll |
Returns a ScrollBar object that provides a scripting interface to the control’s vertical scroll bar. |
wButtonBounds |
Returns the bounding rectangle for the specified item on the control. |
wButtonCount |
Returns the total number of buttons in the toolbar control. |
wButtonID |
Returns the idCommand number for the specified item. |
wButtonPos |
Returns the position of the specified item on the toolbar. |
wButtonText |
Returns the text of a toolbar item. |
wChecked |
Specifies whether a toolbar item is checked or not. |
wDisabledImage |
Provides a scripting interface to the disabled image of a controls’s item. |
wEllipses |
Returns True if the text of a control’s button is cut off and an ellipsis is displayed. |
wEnabled |
Specifies whether a toolbar item is enabled or disabled. |
wGrayed |
Returns True if the specified toolbar item is grayed. |
wHotImage |
Provides a scripting interface to the hot image of a control’s item. |
Width |
Specifies the width of the object in pixels. |
wImage |
Provides a scripting interface to the image of the specified control’s item. |
wIsCheckButton |
Specifies whether a toolbar item has the Check style. |
wIsDropDownButton |
Specifies whether a toolbar item has the DropDown style. |
wIsSeparatorButton |
Specifies whether a toolbar item has the Separator style (that is, whether the item is a separator). |
wLParam |
Returns an application-defined value associated with the button. |
WndCaption |
Specifies the caption of a window object. |
WndClass |
Returns the class name of a window object. |
WndStyles |
Returns a value that is a combination of object style constants. |
WndStylesEx |
Returns a combination of constants that specify an extended object style. |
wRowsCount |
Returns the current number of button rows in a control. |
wStyle |
Returns a combination of constants that specify the styles of a control’s item. |
wVisible |
Specifies whether a toolbar item is visible. |
Standard
This category includes properties that TestComplete applies to all test objects.
Name | Description |
---|---|
_NewEnum
|
Returns an enumerator for the collection of children that belong to the object. |
ChildCount
|
Returns the number of child objects of the given object. |
ControlId |
Specifies the control identifier of the window. |
Enabled |
Specifies whether an object can accept user input or not. |
Exists
|
Tells you whether an object exists in the system. |
Focused |
Specifies whether the control has input focus. |
FullName
|
Specifies the full name that uniquely identifies the object in TestComplete. |
Handle |
Returns the control’s handle (HWND). |
Height |
Specifies the height of the object in pixels. |
Id
|
Returns the object’s identifier. |
Index |
Specifies the front-to-back position of the control among other controls that have the same class name and caption, and belong to the same parent window. |
Left |
Specifies the horizontal position of the object’s left edge relative its parent window. |
MappedName
|
Returns the custom name that is mapped to the original object name and is used to address the object in scripts. |
Name
|
Returns the object name. |
Parent
|
Returns the parent object of the given object. |
ScreenLeft |
Specifies the horizontal position of the object’s left edge in screen coordinates. |
ScreenTop |
Specifies the vertical position of the object’s top edge in screen coordinates. |
Top |
Specifies the vertical position of the object’s top edge relative to the object’s parent window. |
Unicode |
Specifies whether the control is a native Unicode window. |
Visible |
Specifies whether the object is visible to users. |
VisibleOnScreen |
Specifies whether any part of the object is currently visible on screen. |
Width |
Specifies the width of the object in pixels. |
WndCaption |
Specifies the caption of a window object. |
WndClass |
Returns the class name of a window object. |
WndStyles |
Returns a value that is a combination of object style constants. |
WndStylesEx |
Returns a combination of constants that specify an extended object style. |
Extended
This category includes properties that extend test functionality for the MFC Toolbar objects.
Name | Description |
---|---|
HScroll |
Returns a ScrollBar object that provides a scripting interface to the control’s horizontal scroll bar. |
PopupMenu |
Returns a Menu object that provides a scripting interface to the control’s context menu (the menu must be opened on screen first). |
VScroll |
Returns a ScrollBar object that provides a scripting interface to the control’s vertical scroll bar. |
wButtonBounds |
Returns the bounding rectangle for the specified item on the control. |
wButtonCount |
Returns the total number of buttons in the toolbar control. |
wButtonID |
Returns the idCommand number for the specified item. |
wButtonPos |
Returns the position of the specified item on the toolbar. |
wButtonText |
Returns the text of a toolbar item. |
wChecked |
Specifies whether a toolbar item is checked or not. |
wDisabledImage |
Provides a scripting interface to the disabled image of a controls’s item. |
wEllipses |
Returns True if the text of a control’s button is cut off and an ellipsis is displayed. |
wEnabled |
Specifies whether a toolbar item is enabled or disabled. |
wGrayed |
Returns True if the specified toolbar item is grayed. |
wHotImage |
Provides a scripting interface to the hot image of a control’s item. |
wImage |
Provides a scripting interface to the image of the specified control’s item. |
wIsCheckButton |
Specifies whether a toolbar item has the Check style. |
wIsDropDownButton |
Specifies whether a toolbar item has the DropDown style. |
wIsSeparatorButton |
Specifies whether a toolbar item has the Separator style (that is, whether the item is a separator). |
wLParam |
Returns an application-defined value associated with the button. |
wRowsCount |
Returns the current number of button rows in a control. |
wStyle |
Returns a combination of constants that specify the styles of a control’s item. |
wVisible |
Specifies whether a toolbar item is visible. |
<Name Mapping>
These properties are available only if the test object has been mapped (see Name Mapping). You can use them in your tests, but they are not displayed in the Object Browser panel.
Name | Description |
---|---|
NamedChild
|
Returns a child object stored in the Name Mapping repository (by its index). |
NamedChildCount
|
Returns the number of child objects of an object stored in the Name Mapping repository. |
NodeDescription
|
Returns the description of an object stored in the Name Mapping repository. |
Other Categories
If TestComplete has access to internal methods, properties and files of your tested application (that is, if it is an Open Application), you can call the internal methods and properties as methods and properties of the appropriate test objects. You can view these properties and methods in corresponding categories (Private, Public, RTTI, Debug Agent, Firefox, and so on). These methods and properties are not described in the TestComplete help file. For more information on them, please see the documentation for the development tools that was used to create the application under test.
Name | Description |
---|---|
wButtonBounds |
Returns the bounding rectangle for the specified item on the control. |
wButtonCount |
Returns the total number of buttons in the toolbar control. |
wButtonID |
Returns the idCommand number for the specified item. |
wButtonPos |
Returns the position of the specified item on the toolbar. |
wButtonText |
Returns the text of a toolbar item. |
wChecked |
Specifies whether a toolbar item is checked or not. |
wDisabledImage |
Provides a scripting interface to the disabled image of a controls’s item. |
wEllipses |
Returns True if the text of a control’s button is cut off and an ellipsis is displayed. |
wEnabled |
Specifies whether a toolbar item is enabled or disabled. |
wGrayed |
Returns True if the specified toolbar item is grayed. |
wHotImage |
Provides a scripting interface to the hot image of a control’s item. |
wImage |
Provides a scripting interface to the image of the specified control’s item. |
wIsCheckButton |
Specifies whether a toolbar item has the Check style. |
wIsDropDownButton |
Specifies whether a toolbar item has the DropDown style. |
wIsSeparatorButton |
Specifies whether a toolbar item has the Separator style (that is, whether the item is a separator). |
wLParam |
Returns an application-defined value associated with the button. |
wRowsCount |
Returns the current number of button rows in a control. |
wStyle |
Returns a combination of constants that specify the styles of a control’s item. |
wVisible |
Specifies whether a toolbar item is visible. |