Main Content

exportapp

以图像或 PDF 格式捕获 App

自 R2020b 起

    说明

    示例

    exportapp(fig,filename) 导出 fig 指定的图窗的内容,并将其存储在 filename 指定的文件中。必须使用 uifigure 函数或 App 设计工具来创建图窗。捕获所有图形内容,包括 UI 组件。支持的文件类型有 JPEG、PNG、TIFF 和 PDF。

    示例

    全部折叠

    创建一个名为 myapp.m 的程序文件,该文件显示绘图和用于将用户界面导出为文件的按钮。在该按钮的回调函数中,调用 uiputfile 函数来提示用户输入文件名和位置。然后调用 exportapp 函数并在其中包含指定文件的完整路径。

    function myapp
    f = uifigure;
    ax = uiaxes(f,'Position',[25 25 400 375]);
    plot(ax,[0 0.3 0.1 0.6 0.4 1])
    uidropdown(f,'Position',[435 250 90 30],'Items',{'Blue Line','Red Line'});
    uicheckbox(f,'Position',[435 290 90 30],'Text','Grid');
    b = uibutton(f,'Position',[435 200 90 30],'Text','Export');
    b.ButtonPushedFcn = @buttoncallback;
    
        function buttoncallback(~,~)
            filter = {'*.jpg';'*.png';'*.tif';'*.pdf'};
            [filename,filepath] = uiputfile(filter);
            if ischar(filename)
                exportapp(f,[filepath filename]);
            end
        end
    end

    通过调用 myapp 函数来运行该 App。当您点击 App 中的 Export 按钮时,会出现一个对话框,提示您输入文件名和位置。然后,它将图窗内容保存在您指定的文件中。

    myapp

    输入参数

    全部折叠

    使用 uifigure 函数创建的 Figure 对象,或使用 App 设计工具创建的 App 中的图窗。

    如果您使用 App 设计工具开发 App,默认情况下,图窗存储在 UIFigure 属性中。例如,在名为 myapp 的 App 中,图窗存储为 myapp.UIFigure

    如果您运行的是使用 App 设计工具创建的 App 且它没有内置导出功能,请在命令行窗口中执行 mlapp 文件并指定输出参量。然后,使用输出参量访问图窗。例如,以下代码将名为 myapp.mlapp 的 App 导出为 JPEG 文件:

    app = myapp;
    exportapp(app.UIFigure,'appcontent.jpg')

    文件名,指定为包含文件扩展名的字符向量或字符串标量。如果 filename 不包含完整路径,MATLAB® 会将文件保存在当前文件夹中。您必须具有文件的写入权限。

    下表列出了支持的文件格式和文件扩展名(不区分大小写)。

    文件格式文件扩展名

    联合图像专家组 (JPEG)

    'jpg''jpeg'

    可移植网络图形 (PNG)

    'png'

    标记图像文件格式 (TIFF)

    'tif''tiff'

    可移植文档格式 (PDF)

    PDF 在适用的情况下可包含可嵌入字体和向量图内容。

    'pdf'

    局限性

    • MATLAB Online™Web Apps (MATLAB Compiler) 不支持 exportapp

    • 实时编辑器不支持将 App 导出为 PDF 文件。

    版本历史记录

    在 R2020b 中推出