dismissDialog

Programmatically dismiss a nonblocking alert dialog box in front of a figure.

Create a UI figure with a push button that creates a modal alert dialog box when clicked. To program the button behavior, specify its ButtonPushedFcn callback property. See the code of the callback function buttonCallback, which creates an alert dialog box, at the end of this example.

fig = uifigure;
b = uibutton(fig,Text="Close",ButtonPushedFcn=@buttonCallback);

Create a test case for interactive testing.

testCase = matlab.uitest.TestCase.forInteractiveUse;

Test a press gesture on the button. The gesture executes the callback, which creates an alert dialog box in the figure. The alert dialog box is nonblocking and lets you run additional commands while it is open.

testCase.press(b)

Programmatically dismiss the alert dialog box by using the dismissDialog method. The dialog box closes. Because the dialog box in this example specifies the CloseFcn callback, the figure behind the dialog box also closes when the dialog box closes.

testCase.dismissDialog("uialert",fig)

Callback Function

This code shows the callback function used in this example. The buttonCallback function executes when the button in the figure is clicked. The function creates an alert dialog box in the figure. When the dialog box is dismissed, the CloseFcn callback closes the figure.

function buttonCallback(src,~)
uialert(src.Parent,"The figure will close.","Warning", ...
    Icon="warning", ...
    CloseFcn=@(~,~)close(src.Parent))
end

Programmatically dismiss a blocking confirmation dialog box in front of a figure.

Create a UI figure with a push button that creates a modal confirmation dialog box when clicked. To program the button behavior, specify its ButtonPushedFcn callback property. See the code of the callback function buttonCallback, which creates a confirmation dialog box, at the end of this example.

fig = uifigure;
b = uibutton(fig,Text="Close",ButtonPushedFcn=@buttonCallback);

Create a test case for interactive testing.

testCase = matlab.uitest.TestCase.forInteractiveUse;

Testing a press gesture on the button executes the callback, which creates a blocking confirmation dialog box in the figure. Programmatically dismiss the dialog box by using the dismissDialog method. This code first creates the blocking dialog box by invoking the specified function handle, which presses the button in the figure. The method then dismisses the dialog box, which allows code execution to continue.

testCase.dismissDialog("uiconfirm",fig,@() testCase.press(b))

Close the figure used for testing.

close(fig)

Callback Function

This code shows the callback function used in this example. The buttonCallback function executes when the button in the figure is clicked. The function creates a blocking confirmation dialog box in the figure. Selecting the "Proceed" option in the dialog box closes the figure. Selecting the "Cancel" option in the dialog box does not affect the figure.

function buttonCallback(src,~)
selection = uiconfirm(src.Parent,"Close this figure?","Confirm Close", ...
    Icon="warning", ...
    Options=["Proceed" "Cancel"]);

switch selection
    case "Proceed"
        close(src.Parent)
    case "Cancel"
        return
end
end

Programmatically close a sequence of blocking confirmation dialog boxes using the chooseDialog and dismissDialog methods. To close the dialog boxes, first embed all the dialog box creation logic into a function handle, and then perform the final gesture using that function handle.

In a UI figure, create a push button that can result in a sequence of blocking dialog boxes when clicked. To program the button behavior, specify its ButtonPushedFcn callback property.

fig = uifigure;
b = uibutton(fig,Text="Close",ButtonPushedFcn=@buttonCallback);

This code shows the callback function used to create the dialog boxes. The buttonCallback function executes when the button in the figure is clicked. The function creates a blocking confirmation dialog box in the figure with "Proceed" and "Cancel" options:

The reconfirm function executes when the "Proceed" option is selected in the original dialog box. The function creates another blocking confirmation dialog box in the figure with "Yes" and "No" options:

function buttonCallback(src,~)
selection = uiconfirm(src.Parent,"Close this figure?","Confirm Close", ...
    Icon="warning", ...
    Options=["Proceed" "Cancel"]);

switch selection
    case "Proceed"
        reconfirm(src)   % Display another dialog box to reconfirm
    case "Cancel"
        return
end
end

function reconfirm(src)
selection = uiconfirm(src.Parent,"Are you sure?","Confirm Close", ...
    Icon="warning", ...
    Options=["Yes" "No"]);

switch selection
    case "Yes"
        close(src.Parent)   % Close the figure
    case "No"
        return
end
end

To test the app, create a test case for interactive testing. You use this test case first to test a press gesture on the button, which executes the callback and creates a blocking confirmation dialog box in the figure. Then, you programmatically select the "Proceed" option in the dialog box by using the chooseDialog method and dismiss the resulting dialog box by using the dismissDialog method.

testCase = matlab.uitest.TestCase.forInteractiveUse;

Because blocking dialog boxes prevent commands from running while they are open, you cannot call the press, chooseDialog, and dismissDialog methods independently. Instead, you must embed all the dialog box creation logic into a single function handle and then perform the final gesture using that function handle. In this code, fcn1 and fcn2, respectively, specify the code that must run for the first and second dialog boxes to be created. In particular, fcn2 represents all the dialog box creation logic in the test.

fcn1 = @() testCase.press(b);
fcn2 = @() testCase.chooseDialog("uiconfirm",fig,fcn1,"Proceed");

To programmatically close the expected dialog boxes, perform the final gesture using the dismissDialog method with the function handle fcn2 that includes all the dialog box creation logic. This call to the dismissDialog method results in these gestures:

testCase.dismissDialog("uiconfirm",fig,fcn2)

Closing the blocking dialog boxes allows code execution to continue. For example, close the figure used for testing.

close(fig)