Methods' Details |
setMultiSelectionMode
void |
setMultiSelectionMode( |
[in] boolean |
bMode ); |
- Description
- Enable/disable multi-selection mode
If the multi-selection mode is enabled, multiple files
may be selected by the user else only one file selection at a time is possible
- Parameter bMode
A value of `TRUE` enables the multi-selection mode.
A value of `FALSE` disables the multi-selection mode, this is the default.
|
|
setDefaultName
void |
setDefaultName( |
[in] string |
aName ); |
- Description
- Sets the default string that appears in the file name box of a FilePicker.
- Parameter aName
Specifies the default file name, displayed when the FilePicker
is shown. The implementation may accept any string, and does not
have to check for a valid file name or if the file really exists.
|
|
setDisplayDirectory
- Description
- Sets the directory that the file dialog initially displays.
- Parameter aDirectory
- Specifies the initial directory in URL format. The given URL must
conform to Rfc1738).
- Throws
- com::sun::star::lang::IllegalArgumentException
if the URL is invalid (doesn't conform to Rfc1738).
|
|
getDisplayDirectory
string |
getDisplayDirectory(); |
- Description
- Returns the directory that the file dialog is currently showing or
was last showing before closing the dialog with Ok. If the user
did cancel the dialog, the returned value is undefined.
- Returns
- The directory in URL format, must conform to Rfc1738.
|
|
getFiles
sequence< string > |
getFiles(); |
- Usage Restrictions
- deprecated
- Deprecation Info
- use com::sun::star::ui::dialogs::XFilePicker2::getSelectedFiles instead
- Description
- Returns a sequence of the selected files including path information in
URL format, conforming to Rfc1738.
If the user closed the dialog with cancel an empty sequence will be
returned.
If the dialog is in execution mode and a single file is selected
the complete URL of this file will be returned.
If the dialog is in execution mode and the selected file name is false
or any other error occurs an empty sequence will be returned.
- Returns
The complete path of the file or directory currently selected
in URL format. This always returns only the first entry of the sequence.
Notes for the implementation of a FileSave dialog:If there exists
a checkbox "Automatic File Extension" which is checked and a valid filter is currently selected
the dialog may automatically add an extension to the selected file name.
|
|
Copyright © 2020, The Apache Software Foundation, Licensed under the Apache License, Version 2.0. Apache, the Apache feather logo, Apache OpenOffice and OpenOffice.org are trademarks of The Apache Software Foundation. Other names may be trademarks of their respective owners.