Embedded IDE Link™ VS

activate - Make specified project, file, or configuration active

Syntax

activate(vd,'my_project.dpj','project')
activate(vd,'my_file','text')
activate(vd,'my_config','buildcfg')

Description

activate(vd,'my_project.dpj','project') uses handle vd to activate the project named my_project.dpj in the IDE. If my_project.dpj does not exist in the IDE, MATLAB software issues an error that explains that the specified project does not exist.

VisualDSP++ IDE allows you to have two or more projects with the same name open at the same time, such as c:\try11\try11.dpj and c:\try12\try11.dpj. If you use the following function to activate the project try11.dpj at the command prompt, where you do not provide the full path to the project:

activate(vd,'try11.dpj')

Embedded IDE Link VS software cannot tell which project named try11.dpj to activate and may not activate the correct one. The following steps describe how the software decides which project to activate.

1. Search the current VisualDSP++ IDE directory to find the first project with the specified name. If the search finds the project, the software activates the project and returns.

2. If the specified project is not found in the IDE, search the MATLAB path to find a project with this name. If the search finds the project, the software activates the project and returns.

3. If Embedded IDE Link VS software search cannot find a project with the specified name in the VisualDSP++ IDE or on the MATLAB path, the software returns an error saying it could not find the specified project.

activate(vd,'my_file','text') If the document window is open, this command makes the file my_file active in the document window. If the document window is closed, MATLAB returns an error explaining that the document window is closed, and does not activate any file. If the specified file does not exist in the project, MATLAB returns an error. activate supports the text file extensions on the following list:

• .txt

• .c

• .html

• .xml

activate(vd,'my_config','buildcfg')If the IDE application is open, and it contains an active project, activate makes build configuration my_config the active configuration in the IDE. Otherwise, MATLAB returns an error message stating that there is no active project and it could not active the specified build configuration.

See Also

new

remove

Functions — Alphabetical List

add