uiprintdlg

Open figure print dialog box

Since R2025a

Syntax

uiprintdlg

uiprintdlg(fig)

Description

uiprintdlg opens a dialog box with options for printing the current figure (gcf). The current figure is an existing figure that has the HandleVisibility property set to "on". If no such figure exists, MATLAB^® returns an error.

uiprintdlg(fig) opens a dialog box with options for printing the specified figure.

Examples

Open Print Dialog Box for Graph

Create a graph and open a print dialog box using uiprintdlg.

surf(peaks)
uiprintdlg

Clicking Print or Cancel returns you to the command line.

Input Arguments

fig — Figure to print

Figure object

Figure to print, specified as a Figure object.

Limitations

• UI components are not supported. To print the user interface of an app, use the exportapp function to create an image. Then print the image.

• In MATLAB Online™, you can use uiprintdlg to print to PDF, but not to external printers.

More About

Dialog Box Options

Section	Options
Destination	Output destination, such as a physical printer or PDF.
Layout	Paper orientation — Portrait or Landscape. Paper size — A predefined paper size or a custom size. Units — Units for the paper size. This selection also applies to the values under Custom. Scaling No scaling — Do not resize the contents in the figure. Some content might be clipped. Best fit (keep aspect ratio) — Resize the figure to the maximum size that fits on the given paper size without changing the aspect ratio. Fill page (stretch) — Resize the figure to the maximum size that fits on the given paper size, changing the aspect ratio if necessary. Custom — Use the specified width and height of the figure itself and the left and right margins. The Keep centered and Keep aspect ratio options for this setting might crop the image depending on the figure and margin sizes.
Other Settings	Resolution (DPI) — Dots per inch (DPI) in the output. Background color — Color of the space that surrounds the axes or chart. You can enter a color name or an RGB triplet in the box or use the color picker. If you set the Color property of the figure and choose auto, the background stays the same color. If you do not set Color, auto sets the color to white. Color space — Specify RGB for full-color output or Gray for grayscale output.

Version History

Introduced in R2025a