Open figure Print Preview dialog box
printpreview is not supported in App Designer or in apps
created using the
uifigure function. Instead, use
exportapp to create a printable snapshot of your app.
a dialog box showing the figure in the currently active figure window
as it will print. A scaled version of the figure displays in the right-hand
pane of the dialog box.
a dialog box showing the figure having the handle
it will print.
Use the Print Preview dialog box, shown below, to control the layout and appearance of figures before sending them to a printer or print file. Controls are grouped into four tabbed panes: Layout, Lines/Text, Color, and Advanced.
Right Pane Controls
You can position and scale plots on the printed page using the rulers in the right-hand pane of the Print Preview dialog. Use the outer ruler handlebars to change margins. Moving them changes plot proportions. Use the center ruler handlebars to change the position of the plot on the page. Plot proportions do not change, but you can move portions of the plot off the paper. The buttons on that pane let you refresh the plot, close the dialog (preserving all current settings), print the page immediately, or obtain context-sensitive help. Use the Zoom box and scroll bars to view and position page elements more precisely.
The Layout Tab
Use the Layout tab, shown above, to control the paper format and placement of the plot on printed pages. The following table summarizes the Layout options:
Let MATLAB® decide placement of plot on page*
Specify position parameters for plot on page*
Top, Left, Width, Height
Standard position parameters in current units
Revert to default position
Expand figure to fill printable area
Expand figure to fill printable area, center the figure, and preserve the figure’s aspect ratio
Center plot on printed page
U.S. and ISO® sheet size selector
Sheet size in current units
Use inches as units for dimensions and positions
Use centimeters as units for dimensions and positions
Use points as units for dimensions and positions
Upright paper orientation
Sideways paper orientation
Currently the same as Landscape
* Selecting Auto in
the Placement group sets the figure
disables the controls in that panel. Selecting Use manual
size and position sets the figure
enables the controls. If you set
the print preview Placement controls respond accordingly.
The Lines/Text Tab
Use the Lines/Text tab, shown below, to control the line weights, font characteristics, and headers for printed pages. The following table summarizes the Lines/Text options:
Scale all lines by a percentage from 0 upward (100 being no change), print lines at a specified point size, or default line widths used on the plot
Smallest line width (in points) to use when printing; defaults to 0.5 point
Select a system font for all text on plot, or default to fonts currently used on the plot
Scale all text by a percentage from 0 upward (100 being no change), print text at a specified point size, or default to this used on the plot
Type the text to appear on the header at the upper left of printed pages, or leave blank for no header. Header text only supports plain text characters.
Select a date format to have today's date appear on each printed page, or
The Color Tab
Use the Color tab, shown below, to control how colors are printed for lines and backgrounds. The following table summarizes the Color options:
Black and White
Select to print lines and text in black and white, but use color for patches and other objects
Convert colors to shades of gray on printed pages
Print everything in color, matching colors on plot; select
Same as figure
Print the figure's background color as it is
Select a color name, or type a colorspec for the background;
The Advanced Tab
Use the Advanced tab, shown below, to control finer details of printing, such as limits and ticks, renderer, resolution, and the printing of UIControls. The following table summarizes the Advanced options:
Axes limits and ticks
Recompute limits and ticks
Redraw x- and y-axes ticks and limits based on printed plot size (default)
Keep screen limits and ticks
Use the x- and y-axes ticks and limits shown on the plot when printing the previewed figure
Select a rendering algorithm for printing:
Select resolution to print at in dots per inch:
Print all visible UIControls in the figure (default), or uncheck to exclude them from being printed
Use File > Print Preview on the figure window menu to access the Print Preview dialog box, described below. For details, see Print Figure from File Menu.
Introduced before R2006a