Skip to main content

Zemax OpticStudio ZOS-API 2026 R1

Interface ZOSAPI::Tools::General::IRestoreProject

Last update: 13.03.2026

Definition:

Inherits from:

Members

Properties

Property ArchiveFile

Definition:

string ZOSAPI.Tools.General.IRestoreProject.ArchiveFile

Gets the name of the currently selected input archive.

The full path to the archive file.

Return type: string

Property NumberOfFilesInArchive

Definition:

int ZOSAPI.Tools.General.IRestoreProject.NumberOfFilesInArchive

Gets the number of files stored in the specified archive.

The number of files in archive.

Return type: int

Property NumberOfAdditionalFiles

Definition:

int ZOSAPI.Tools.General.IRestoreProject.NumberOfAdditionalFiles

Return type: int

Public functions

Function SetFileName

ArchiveFileStatus ZOSAPI.Tools.General.IRestoreProject.SetFileName(string archiveFile)

Sets the name of the input archive.

Parameters:

  • archiveFile: The full path to the archive file.

Returns:

The results from trying to read the archive.

Parameters:

  • string archiveFile

Return type: ArchiveFileStatus

Function GetOutputFolder

string ZOSAPI.Tools.General.IRestoreProject.GetOutputFolder()

Gets the currently selected output folder.

Returns:

Return type: string

Function SetOutputFolder

bool ZOSAPI.Tools.General.IRestoreProject.SetOutputFolder(string folder)

Sets the desired output folder.

Parameters:

  • folder: The folder.

Returns:

true

if the specified folder is valid and exists; otherwise,

false

.

Parameters:

  • string folder

Return type: bool

Function GetFileNameInArchive

string ZOSAPI.Tools.General.IRestoreProject.GetFileNameInArchive(int fileNumber)

Gets the file name for the specified file in the archive.

Parameters:

  • fileNumber: The file number (0 - NumberOfFilesInArchive-1).

Returns:

Parameters:

  • int fileNumber

Return type: string

Function SetFileOverwrite

void ZOSAPI.Tools.General.IRestoreProject.SetFileOverwrite(int fileNumber, bool allowOverwrite)

Sets a flag determining whether the file at the specified index will be overwritten if it already exists.

Parameters:

  • fileNumber: The file number (see GetFileNameInArchive).
  • allowOverwrite: if set to true the file will be overwritten; otherwise it will be skipped.

Parameters:

  • int fileNumber
  • bool allowOverwrite

Return type: void

Function SetFilesAllOverwrite

void ZOSAPI.Tools.General.IRestoreProject.SetFilesAllOverwrite()

All files will be overwritten if they exist.

Return type: void

Function SetFilesNoOverwrite

void ZOSAPI.Tools.General.IRestoreProject.SetFilesNoOverwrite()

No files will be overwritten.

Return type: void

Function GetFile

FileManager.IFile ZOSAPI.Tools.General.IRestoreProject.GetFile(int fileNumber)

Parameters:

  • int fileNumber

Return type: FileManager.IFile

Function UseProjectFile

bool ZOSAPI.Tools.General.IRestoreProject.UseProjectFile(int fileNumber)

Parameters:

  • int fileNumber

Return type: bool

Function UseRootFile

bool ZOSAPI.Tools.General.IRestoreProject.UseRootFile(int fileNumber)

Parameters:

  • int fileNumber

Return type: bool

Function SetAllFilesToProject

bool ZOSAPI.Tools.General.IRestoreProject.SetAllFilesToProject()

Return type: bool

Function SetAllFilesToRoot

bool ZOSAPI.Tools.General.IRestoreProject.SetAllFilesToRoot()

Return type: bool

Function GetAdditionalFile

FileManager.IFile ZOSAPI.Tools.General.IRestoreProject.GetAdditionalFile(int addfileNumber)

Parameters:

  • int addfileNumber

Return type: FileManager.IFile

Connect with Ansys