simulinkproject

R2026b

（不推荐）打开工程并获取工程对象

全页折叠

不推荐使用 simulinkproject。请改用 currentProject 或 openProject。有关详细信息，请参阅版本历史记录。

语法

simulinkproject
simulinkproject(projectPath)
proj = simulinkproject
proj = simulinkproject(projectPath)

描述

simulinkproject 打开工程或将焦点置于该工具（如果该工具已打开）。打开该工具后，您可以创建工程或使用工程选项卡访问最近的工程。

示例

simulinkproject(projectPath) 打开 projectPath 中的工程根文件夹下的任意文件或文件夹指定的工程，并将焦点赋予该工程。

示例

proj = simulinkproject 返回一个工程对象 proj，您可以在命令行中使用该对象操作工程。在可以使用任何其他工程功能前，您需要获取工程对象。

示例

proj = simulinkproject(projectPath) 会打开 projectPath 指定的工程并返回一个工程对象。

示例

示例

全部折叠

打开工程工具。

simulinkproject

指定 .prj 文件路径或包含您的 .SimulinkProject 文件夹和 .prj 文件的文件夹。工程随即打开，并将焦点赋予工程。

simulinkproject('C:/projects/project1/')

打开指定工程并获取工程对象，以在命令行操作工程。为避免启动脚本打开的窗口从 MATLAB® 桌面带走焦点，请使用 start_simulink 而不是 simulink 函数，并使用带输出参量的 simulinkproject 而不是 uiopen。如果使用 uiopen(myproject.prj)，这将调用不带输出参量的 simulinkproject，并将焦点赋予工程。

start_simulink
proj = simulinkproject('C:/projects/project1/myproject.prj')

打开 Airframe 工程并创建工程对象以在命令行操作和浏览该工程。

openExample('simulink/AirframeProjectExample')
proj = simulinkproject
proj = 

  ProjectManager with properties:

             Name: 'Simulink Project Airframe Example'
      Information: [1x1 slproject.Information]
     Dependencies: [1x1 slproject.Dependencies]
       Categories: [1×1 slproject.Category]
            Files: [1×31 slproject.ProjectFile]
        Shortcuts: [1×7 slproject.Shortcut]
      ProjectPath: [1×7 slproject.PathFolder]
ProjectReferences: [1×0 slproject.ProjectReference]
     StartupFiles: [1×0 slproject.StartupFile]
    ShutdownFiles: [1×0 slproject.ShutdownFile]
       RootFolder: 'C:\slexamples\airframe11'

了解您可以对工程执行哪些操作。

methods(proj)

Methods for class slproject.ProjectManager:


addFile                       
addFolderIncludingChildFiles  
addPath                       
addReference                  
addShortcut                   
addShutdownFile                    
addStartupFile
close                         
createCategory                
export                        
findCategory                  
findFile                      
isLoaded                      
listModifiedFiles             
listRequiredFiles             
refreshSourceControl          
reload                        
removeCategory                
removeFile                    
removePath                    
removeReference               
removeShortcut
removeShutdownFile
RemoveStartupFile

在使用 simulinkproject 函数获取工程对象后，可以检查工程属性。

检查工程文件。

files = proj.Files

files = 

  1x31 ProjectFile array with properties:

    Path
    Labels
    Revision
    SourceControlStatus

使用索引访问此列表中的文件。以下命令将获取第 14 个文件。每个文件都具有描述其路径、连接的标签和源代码管理信息的属性。

proj.Files(15)
ans = 

  ProjectFile with properties:

      Path: 'C:\slexamples\airframe24\models\DigitalControl.slx'
                 Labels: [1x1 slproject.Label]
               Revision: '2'
    SourceControlStatus: Unmodified

检查文件的标签。

proj.Files(15).Labels

ans = 

  Label with properties:

File: 'C:\slexamples\airframe24\models\DigitalControl.slx'
        DataType: 'none'
            Data: []
            Name: 'Design'
    CategoryName: 'Classification'

按名称获取特定文件。 

myfile = findFile(proj,'models/AnalogControl.slx')
myfile = 

  ProjectFile with properties:

  Path: 'C:\slexamples\airframe24\models\AnalogControl.slx'
                 Labels: [1×1 slproject.Label]
               Revision: '2'
    SourceControlStatus: Unmodified

了解您可以对文件执行哪些操作。

methods(myfile)

Methods for class slproject.ProjectFile:

addLabel     findLabel    removeLabel

更新文件依赖关系。

update(proj.Dependencies)

工程会运行依赖关系分析以更新工程文件之间的已知依赖关系。

输入参数

全部折叠

工程 .prj 文件的完整路径、工程根文件夹的路径或工程根文件夹下的任何子文件夹或文件，指定为字符向量。

示例: 'C:/projects/project1/myProject.prj'

示例: 'C:/projects/project1/'

输出参量

全部折叠

工程，以工程对象形式返回。使用工程对象可在命令行操作当前打开的工程。

proj 输出参量的属性。

工程属性描述
类别工程标签的类别
依赖关系MATLAB 有向图对象中的工程文件之间的依赖关系
文件工程文件的路径和名称
信息有关工程的信息，如描述、源代码管理集成、仓库位置以及是否为顶层工程
名称工程名称
ProjectPath

MATLAB 路径中放置工程的文件夹

ProjectReferences包含引用的工程的文件夹。包含用于引用的工程的只读工程对象。
RootFolder工程根文件夹的完整路径
快捷方式此工程中快捷方式的数组
ShutdownFiles此工程中关闭文件的数组
StartupFiles此工程中启动文件的数组

提示

或者，您可以使用 slproject.loadProject 加载工程，然后使用 slproject.getCurrentProjects 获取工程对象。使用 simulinkproject 打开工程，并以交互方式浏览工程。将 slproject.getCurrentProjects 和 slproject.loadProject 用于工程自动化脚本。

版本历史记录

在 R2012a 中推出

全部折叠

另请参阅

函数