IAdeUICallbacks::GetFilename

ADE User Guide > ADE Server Class Reference > IAdeUICallbacks

string GetFilename([in] string function, [in] string defaultName, [in] string directory, [in] string extensions, [in] string caption, [in] CAObject* callingIdent)

当用户被要求选择以文件名时，在任何一个函数被计算时调用。这些函数包括SpreadsheetOpen()、ReadTextFile()、ReadImageFile()和 ReadExportFile。

Your implementation should allow the user to select a file, or if your are implementing a web-based application, you may allow him to upload a file.

After the file is read, the IAdeUICallbacks::FileOpenCompleted() is called. If your application has uploaded a file to a temporary location, you can safely delete the temporary file here.

The method is not called if the dialog is unnecessary.

参 数

• «function»: the identifier of the built-in function that is requesting the filename. E.g., "SpreadsheetOpen", "ReadTextFile", "ReadImageFile", or "ReadExportFile".
• «directory»: The current directory.
• «extensions»: A list of file extensions to filter for. When there is more that one possible extension, they are separated by a double bar, "||". Each extension has two parts, separated by a single bar, "|". The first part is a list of wild cards such as "*.txt;*.dat", each wildcard separated by semi-colons. The second part is a user-friendly description of the extension. For example, SpreadsheetOpen may provide the following filter: "*.xl*;*.csv|Excel Files (*.xl*;*.csv)||*.*|All Files (*.*)"
• «caption»: The recommended title or caption text for a file open dialog.
• «callingIdent»: A CAObject pointer to the user-object in the model that is calling the build-in function.

返回值

被选择或卸载文件的完整路径。

另请参考

• IAdeUICallbacks::FileOpenCompleted方法
• SpreadsheetOpen、ReadTextFile、ReadExportFile、ReadImageFile函数