.NET ToolStrip

Pega Robotic Automation supports the integration of the .NET 2.0 ToolStrip control. This topic describes how to interrogate a ToolStrip target and its contained elements. In addition, definitions for the available properties, methods, and events for the ToolStrip control and the ToolStrip elements. For more information on the .NET ToolStrip, see the MSDN ToolStrip Class topic.

ToolStrip Properties, Methods and Events

To integrate a ToolStrip and its associated elements from a Windows application into a Studio project, use the Windows application adapter and interrogate the ToolStrip target directly using the Interrogation function. A ToolStrip control is created under its parent in Object Explorer.

You can directly interrogate some ToolStrip elements – such as TextBoxes, ComboBoxes, and ProgressBars. For more information, see the ToolStrip Elements table.

Other ToolStrip elements cannot be interrogated directly: DropDownButton, MenuItem, and SplitButton. For these, use the Add Menu/DropDown Items option as described in the ToolStrip Elements table.

For the ToolStrip control, Pega Robotic Automation supports most of the standard Windows control properties, methods and events with the following exceptions.

These methods are not supported:

DestroyedTooltip
Focus
HideTooltip
ShowTooltip

Keep in mind...

ShowContextMenu methods execute the corresponding PerformRightClick methods. For example, calling ShowContextMenu(Int32 x, Int 32 y) executes the PerformRightClick(Int32 x, Int32 y) method.
The timeout parameter for the PerformSynchronousClick methods is not implemented. Any value supplied for this parameter is ignored.

These events are not supported:

Clicking
DoubleClicking
RightClicking
GotFocus
LostFocus
KeyDown
KeyPress
KeyUp
Cut
Copy
Paste

ToolStrip Elements

Pega Robotic Automation supports these elements contained within a ToolStrip:

ToolStrip Element	Description
ToolStripTextBox ToolStripComboBox ToolStripProgressBar	Interrogate directly using the Interrogation function to create a standard Windows TextBox, ComboBox, and ProgressBar controls in Studio. The properties, methods, and events available for these controls are all of the standard Windows control along with those corresponding to the specific control, such as the ComboBox.SelectedIndex property.
ToolStripButton	Interrogate directly using the Interrogation function to create a Button control in Studio. Pega Robotic Automation supports most of the standard Button controls methods and events with the exceptions noted above for the ToolStrip control.
ToolStripLabel	Interrogate directly using the Interrogation function to create a Label control in Studio. Pega Robotic Automation supports most of the standard Label methods and events with the exceptions noted above for the ToolStrip control.
ToolStripMenuItem ToolStripDropDownButton ToolStripSplitButton	To integrate these targets, right-click on the ToolStrip control in Object Explorer and select the Add Menu/DropDown Items option. The Add Menu Items window is displayed. For these controls, Studio uses the .NET Name match rule. Note: Studio does not support interrogation of non-menu item drop-down elements, such as text boxes and combo boxes. For more information, see .NET MenuStrip. The standard Windows control properties, methods, and events apply to these ToolStrip items with the following exceptions: These properties always return zero (0) as their value: Bottom BoundsRetangle Left Right Top The Visible property always returns a False value. Note: The ToolStripMenuItem (.NET MenuStrip) control has a Checked property which returns True if the menu item is checked. This property is read-only. To check or uncheck a menu item, use the PerformClick method for the menu item. These methods are not supported: DestroyedTooltip Focus HideTooltip ShowTooltip Note: The PerformClick methods can only be called on TooStripSplitButton ToolStrip element. These events are not supported: Clicking DoubleClicking RightClicking GotFocus LostFocus KeyDown KeyPress KeyUp Cut Copy Paste