<html> <head> <title>Interface XFilePicker</title> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link rel="stylesheet" type="text/css" href="../../../../../idl.css"> </head> <body> <div id="adc-idlref"> <a name="_top_"> </a><table class="navimain" border="0" cellpadding="3"> <tr> <td class="navimain"><a href="../../module-ix.html" class="navimain">Overview</a></td> <td class="navimain"><a href="module-ix.html" class="navimain">Module</a></td> <td class="navimain"><a href="XFilePicker-xref.html" class="navimain">Use</a></td> <td class="navimainnone">Devguide</td> <td class="navimain"><a href="../../../../../index-files/index-1.html" class="navimain">Index</a></td> </tr> </table> <table class="navisub" border="0" cellpadding="0"> <tr> <td class="navisub"><a href="#MethodsSummary" class="navisub">Methods' Summary</a></td> <td class="navisub">Attributes' Summary</td> <td class="navisub"><a href="#MethodsDetails" class="navisub">Methods' Details</a></td> <td class="navisub">Attributes' Details</td> </tr> </table> <hr> <table border="0" width="100%" cellpadding="5" cellspacing="3" class="title-table" style="margin-bottom:6pt;"> <tr> <td><p class="namechain"><a href="../../../../../module-ix.html" class="namechain">::</a> <a href="../../../../module-ix.html" class="namechain">com</a> :: <a href="../../../module-ix.html" class="namechain">sun</a> :: <a href="../../module-ix.html" class="namechain">star</a> :: <a href="../module-ix.html" class="namechain">ui</a> :: <a href="module-ix.html" class="namechain">dialogs</a> :: </p> </td> </tr> <tr> <td class="title">interface XFilePicker</td> </tr> <tr> <td><dl> <dt><b>Base Interfaces</b></dt> <dd><pre style="font-family:monospace;"><strong>XFilePicker</strong> ┗ <a href="XExecutableDialog.html">XExecutableDialog</a> </pre></dd> <dd><a name/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="crosstitle"> <tr> <td class="imsum_left"><a href="XExecutableDialog.html">XExecutableDialog</a></td> <td class="imsum_right"><dl> <dt>(referenced interface's summary:)</dt> <dd>Specifies an interface for an executable dialog. </dd> </dl> </td> </tr> </table> </dd> </dl> </td> </tr> <tr> <td><dl> <dt><b>Description</b></dt> <dd>Specifies an interface for a FilePicker </dd> </dl> </td> </tr> </table> <hr> <a name="MethodsSummary"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle" colspan="2">Methods' Summary</td> </tr> <tr> <td class="imsum_left"><a href="#setMultiSelectionMode">setMultiSelectionMode</a></td> <td class="imsum_right">Enable/disable multi-selection mode </td> </tr> <tr> <td class="imsum_left"><a href="#setDefaultName">setDefaultName</a></td> <td class="imsum_right">Sets the default string that appears in the file name box of a FilePicker. </td> </tr> <tr> <td class="imsum_left"><a href="#setDisplayDirectory">setDisplayDirectory</a></td> <td class="imsum_right">Sets the directory that the file dialog initially displays. </td> </tr> <tr> <td class="imsum_left"><a href="#getDisplayDirectory">getDisplayDirectory</a></td> <td class="imsum_right">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. </td> </tr> <tr> <td class="imsum_left"><a href="#getFiles">getFiles</a></td> <td class="imsum_right">Returns a sequence of the selected files including path information in URL format, conform to <a href="http://www.w3.org/Addressing/rfc1738.txt">Rfc1738</a>. </td> </tr> </table> <a name="MethodsDetails"/><table border="1" width="100%" cellpadding="5" cellspacing="0" class="subtitle"> <tr> <td class="subtitle">Methods' Details</td> </tr> <tr> <td class="imdetail"><a name="setMultiSelectionMode" class="membertitle">setMultiSelectionMode</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">void</td> </tr> <tr> <td valign="top"><b>setMultiSelectionMode</b>(</td> <td valign="top">[in] boolean</td> <td valign="bottom"> bMode );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Enable/disable multi-selection mode </dd> <dd><p>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</p> </dd> <dt><b>Parameter bMode</b></dt> <dd><p>A value of <b>true</b> enables the multi-selection mode.</p> <p>A value of <b>false</b> disables the multi-selection mode, this is the default.</p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="setDefaultName" class="membertitle">setDefaultName</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">void</td> </tr> <tr> <td valign="top"><b>setDefaultName</b>(</td> <td valign="top">[in] string</td> <td valign="bottom"> aName );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Sets the default string that appears in the file name box of a FilePicker. </dd> <dt><b>Parameter aName</b></dt> <dd><p> 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. </p> </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="setDisplayDirectory" class="membertitle">setDisplayDirectory</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">void</td> </tr> <tr> <td valign="top"><b>setDisplayDirectory</b>(</td> <td valign="top">[in] string</td> <td valign="bottom"> aDirectory )</td> </tr> <tr> <td valign="top" align="right">raises( </td> <td valign="top" colspan="2">::com::sun::star::<a href="../../lang/module-ix.html">lang</a>::<a href="../../lang/IllegalArgumentException.html">IllegalArgumentException</a> );</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Sets the directory that the file dialog initially displays. </dd> <dt><b>Parameter aDirectory</b></dt> <dd>Specifies the initial directory in URL format. The given URL must be conform to <a href="http://www.w3.org/Addressing/rfc1738.txt">Rfc1738</a>). </dd> <dt><b>Throws</b></dt> <dd>com::sun::star::lang::IllegalArgumentException if the URL is invalid (doesn't conform to <a href="http://www.w3.org/Addressing/rfc1738.txt">Rfc1738</a>). </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="getDisplayDirectory" class="membertitle">getDisplayDirectory</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">string</td> </tr> <tr> <td valign="top"><b>getDisplayDirectory</b>();</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>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. </dd> <dt><b>Returns</b></dt> <dd>The directory in URL format, must be conform to <a href="http://www.w3.org/Addressing/rfc1738.txt">Rfc1738</a>. </dd> </dl> </td> </tr> </table> </td> </tr> <tr> <td class="imdetail"><a name="getFiles" class="membertitle">getFiles</a><table border="0" width="96%" cellpadding="5" cellspacing="0" class="table-in-method" bgcolor="#ffffff" align="center"> <tr> <td><table class="table-in-method" border="0"> <tr> <td valign="top" colspan="3">sequence< string ></td> </tr> <tr> <td valign="top"><b>getFiles</b>();</td> </tr> </table> <hr> <dl> <dt><b>Description</b></dt> <dd>Returns a sequence of the selected files including path information in URL format, conform to <a href="http://www.w3.org/Addressing/rfc1738.txt">Rfc1738</a>. </dd> <dd><p>If the user closed the dialog with cancel an empty sequence will be returned.</p> <br/> <p>If the dialog is in execution mode and a single file is selected the complete URL of this file will be returned.</p> <p>If the dialog is in execution mode and multiple files are selected an empty sequence will be returned.</p> <p>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.</p> </dd> <dt><b>Returns</b></dt> <dd><p> The complete path of the file or directory currently selected in URL format. There are two different cases: <ol> <li>Multi-selection is disabled: The first and only entry of the sequence contains the complete path/filename in URL format.</li> <li>Multi-selection is enabled: If only one file is selected, the first entry of the sequence contains the complete path/filename in URL format. If multiple files are selected, the first entry of the sequence contains the path in URL format, and the other entries contains the names of the selected files without path information.</li> </ol> <br/> <p><strong>Notes for the implementation of a FileSave dialog:</strong>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.</p> </p> </dd> </dl> </td> </tr> </table> </td> </tr> </table> <a href="#_top_">Top of Page</a><hr size="3"><p class="copyright" align="center">Copyright © 2000, 2012 LibreOffice contributors and/or their affiliates. All rights reserved.</p><p class="copyright" align="center">LibreOffice was created by The Document Foundation, based on OpenOffice.org, which is Copyright 2000, 2010 Oracle and/or its affiliates.</p><p class="copyright" align="center">The Document Foundation acknowledges all community members, please find more info <a href="http://www.libreoffice.org/about-us/credits/" target="_blank">at our website</a>.<p> </p><p class="copyright" align="center"><a href="http://www.libreoffice.org/privacy" target="_blank">Privacy Policy</a> | <a href="http://www.libreoffice.org/imprint" target="_blank">Impressum (Legal Info)</a> | Copyright information: The source code of LibreOffice is licensed under the GNU Lesser General Public License (<a href="http://www.libreoffice.org/download/license/" target="_blank">LGPLv3</a>). "LibreOffice" and "The Document Foundation" are registered trademarks of their corresponding registered owners or are in actual use as trademarks in one or more countries. Their respective logos and icons are also subject to international copyright laws. Use thereof is explained in our <a href="http://wiki.documentfoundation.org/TradeMark_Policy" target="_blank">trademark policy</a>.</p> </div> <!-- id="adc-idlref" --> </body> </html>