chooseContextMenu

Class: matlab.uitest.TestCase
Package: matlab.uitest

Perform choose gesture on context menu item

Since R2020b

Syntax

chooseContextMenu(testcase,comp,menuitem)

chooseContextMenu(testcase,comp,menuitem,location)

chooseContextMenu(testcase,uit,menuitem,indices)

Description

chooseContextMenu(testcase,comp,menuitem) performs a right-click at the center of the UI component comp to open a context menu. The method then chooses the specified menuitem.

chooseContextMenu(testcase,comp,menuitem,location) specifies the location to open the context menu within the component. You can only specify location with five of the available components: axes, UI axes, polar axes, panel, and UI figure.

chooseContextMenu(testcase,uit,menuitem,indices) right-clicks the cell specified by indices within the table UI component uit. The method then chooses the specified menuitem.

Input Arguments

testcase — Instance of test case

matlab.uitest.TestCase object

Instance of the test case, specified as a matlab.uitest.TestCase object.

comp — UI component with context menu

UI component object

UI component with the context menu, specified as a UI component object. The context menu must include the menu item specified by menuitem. Components that support a context menu include images, buttons, switches, axes, and figures.

Supported Component	Typical Creation Function
Axes	axes
Button	uibutton
Check Box	uicheckbox
Date Picker	uidatepicker
Discrete Knob	uiknob
Drop Down	uidropdown
Edit Field (Numeric, Text)	uieditfield
Image	uiimage
Knob	uiknob
Label	uilabel
List Box	uilistbox
Panel	uipanel
Polar Axes	polaraxes
Radio Button	uiradiobutton
Slider	uislider
Spinner	uispinner
State Button	uibutton
Switch (Rocker, Slider, Toggle)	uiswitch
Text Area	uitextarea
Toggle Button	uitogglebutton
Tree Node	uitreenode
UI Axes	uiaxes
UI Figure	uifigure

Example: uifigure

Example: axes('Position',[0.1 0.1 .6 .6])

Example: uispinner('Limits',[0 10],'Value',5)

menuitem — Context menu item to choose

matlab.ui.container.Menu object

Context menu item to choose during the test, specified as a matlab.ui.container.Menu object. Menu items are created with the uimenu function.

location — Location to open context menu

1-by-2 or 1-by-3 numeric array

Location to open the context menu within the UI component, specified as the coordinates of the point. The form of location depends on the UI component:

• Axes and UI Axes — A 1-by-2 or 1-by-3 numeric array containing x-, y-, and optionally z-coordinates.

• Polar Axes — A 1-by-2 numeric array containing θ- and r-coordinates.

• Panel and UI Figure — A 1-by-2 numeric array containing x- and y-coordinates. Specify the coordinates of the point to right-click measured in pixels from the lower-left corner of the component.

Example: [32.5 13 0.25] (UI axes)

Example: [pi/2 0.5] (Polar axes)

Example: [100 200] (UI figure)

uit — Target table UI component

matlab.ui.control.Table object

Target table UI component, specified as a matlab.ui.control.Table object. Table UI components are created with the uitable function.

indices — Indices of table cell

1-by-2 vector

Indices of the table cell to right-click, specified as a 1-by-2 vector with the row index appearing before the column index.

Example: [2 3]

Attributes

Sealed

true

To learn about attributes of methods, see Method Attributes.

Examples

Choose Context Menu Item for UI Figure

Create a context menu with two menu items in a UI figure. Assign the context menu to the figure by setting the ContextMenu property of the figure to the ContextMenu object. To view the context menu, right-click anywhere in the figure window.

fig = uifigure;

cm = uicontextmenu(fig);
m1 = uimenu(cm,'Text','Menu1');
m2 = uimenu(cm,'Text','Menu2');

fig.ContextMenu = cm;

Create an interactive test case and choose the menu item m1. The context menu and a blue dot appear at the center of the figure. Then, a second blue dot representing the programmatic choose gesture appears and disappears at the center of the selected menu item.

tc = matlab.uitest.TestCase.forInteractiveUse;
tc.chooseContextMenu(fig,m1)

Choose Context Menu Item at Specified Location

Create an Axes object in a UI figure. Assign a context menu with two menu items to the Axes object.

fig = uifigure;
ax = axes(fig);

cm = uicontextmenu(fig);
m1 = uimenu(cm,'Text','Menu1');
m2 = uimenu(cm,'Text','Menu2');

ax.ContextMenu = cm;

Create an interactive test case and choose the menu item m2 by opening the context menu for the axes at the coordinates (0.85,0.2). The context menu and a blue dot appear at the specified axes coordinates. Then, a second blue dot representing the programmatic choose gesture appears and disappears at the center of the second menu item.

tc = matlab.uitest.TestCase.forInteractiveUse;
tc.chooseContextMenu(ax,m2,[0.85 0.2]);

Choose Context Menu Item for Specified Table Cell

Create a table UI component that contains a mixture of different data types. Then, assign a context menu with two items to the table.

fig = uifigure;
uit = uitable(fig);
d = {'Male',52,true;'Male',40,true;'Female',25,false};
uit.Data = d;

cm = uicontextmenu(fig);
m1 = uimenu(cm,'Text','Menu1');
m2 = uimenu(cm,'Text','Menu2');
uit.ContextMenu = cm;

Create an interactive test case and choose the menu item m2 by opening the context menu within the table cell with indices (1,1).

tc = matlab.uitest.TestCase.forInteractiveUse;
tc.chooseContextMenu(uit,m2,[1 1])

Version History

Introduced in R2020b

R2023a: Perform gestures on labels

You can test a right-click to open a context menu within label components.

R2021a: Perform gestures on panels and tables

You can test a right-click to open a context menu within panels and table UI components.