![]() System : Linux absol.cf 5.4.0-198-generic #218-Ubuntu SMP Fri Sep 27 20:18:53 UTC 2024 x86_64 User : www-data ( 33) PHP Version : 7.4.33 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, Directory : /usr/share/GNUstep/Documentation/Developer/Gui/Reference/ |
Upload File : |
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> <head> <title>NSOpenPanel</title> </head> <body> <font face="serif"> <a href="Gui.html">Up</a> <br /> <h1><a name="title$NSOpenPanel">NSOpenPanel</a></h1> <h3>Authors</h3> <dl> <dt>Scott Christley (<a href="mailto:scottc@net-community.com"><code>scottc@net-community.com</code></a>)</dt> <dd> </dd> <dt>Daniel Boehringer (<a href="mailto:boehring@biomed.ruhr-uni-bochum.de"><code>boehring@biomed.ruhr-uni-bochum.de</code></a>)</dt> <dd> </dd> <dt>Nicola Pero (<a href="mailto:n.pero@mi.flashnet.it"><code>n.pero@mi.flashnet.it</code></a>)</dt> <dd> </dd> <dt>Mirko Viviani (<a href="mailto:mirko.viviani@rccr.cremona.it"><code>mirko.viviani@rccr.cremona.it</code></a>)</dt> <dd> </dd> </dl> <blockquote> Standard panel for opening files </blockquote> <p><b>Copyright:</b> (C) 1996, 1998, 1999, 2000 Free Software Foundation, Inc. </p> <div> </div> <h1><a name="001000000000"> Software documentation for the NSOpenPanel class </a></h1> <h2><a name="class$NSOpenPanel">NSOpenPanel</a> : <a rel="gsdoc" href="NSSavePanel.html#class$NSSavePanel">NSSavePanel</a></h2> <blockquote class="declared"> <dl> <dt><b>Declared in:</b></dt> <dd>AppKit/NSOpenPanel.h</dd> </dl> </blockquote> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Implements a panel that allows the user to select a file or files. NSOpenPanel is based on the NSSavePanel implementation and shares a lot of similarities with it. </p> <p> </p> <p> There is only one open panel per application and this panel is obtained by calling the <a rel="gsdoc" href="#method$NSOpenPanel+openPanel"> +openPanel </a> class method. From here, you should set the characteristics of the file selection mechanism using the <a rel="gsdoc" href="#method$NSOpenPanel-setCanChooseFiles$"> -setCanChooseFiles: </a> , <a rel="gsdoc" href="#method$NSOpenPanel-setCanChooseDirectories$"> -setCanChooseDirectories: </a> and <a rel="gsdoc" href="#method$NSOpenPanel-setAllowsMultipleSelection$"> -setAllowsMultipleSelection: </a> methods. The default is <code>YES</code> except for allowing multiple selection. When ready to show the panel, use the <a rel="gsdoc" href="#method$NSOpenPanel-runModalForTypes$"> -runModalForTypes: </a> , or a similar method to show the panel in a modal session. Other methods allow you to set the initial directory and initially selected file. The method will return one of NSOKButton or NSCancelButton depending on which button the user pressed. </p> <p> </p> <p> Use the <a rel="gsdoc" href="NSSavePanel.html#method$NSSavePanel-filename"> [NSSavePanel -filename] </a> or <a rel="gsdoc" href="#method$NSOpenPanel-filenames">-filenames</a> method to retrieve the name of the file the user selected. </p> <p> </div> <hr width="50%" align="left" /> <a href="#_NSOpenPanel_ivars">Instance Variables</a> <br/><br/> <b>Method summary</b> <ul> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel+openPanel">+openPanel</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-URLs">-URLs</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-allowsMultipleSelection">-allowsMultipleSelection</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-beginForDirectory$file$types$modelessDelegate$didEndSelector$contextInfo$">-beginForDirectory:file:types:modelessDelegate:didEndSelector:contextInfo:</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-beginSheetForDirectory$file$types$modalForWindow$modalDelegate$didEndSelector$contextInfo$">-beginSheetForDirectory:file:types:modalForWindow:modalDelegate:didEndSelector:contextInfo:</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-canChooseDirectories">-canChooseDirectories</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-canChooseFiles">-canChooseFiles</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-filenames">-filenames</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-resolvesAliases">-resolvesAliases</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-runModalForDirectory$file$types$">-runModalForDirectory:file:types:</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-runModalForDirectory$file$types$relativeToWindow$">-runModalForDirectory:file:types:relativeToWindow:</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-runModalForTypes$">-runModalForTypes:</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-setAllowsMultipleSelection$">-setAllowsMultipleSelection:</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-setCanChooseDirectories$">-setCanChooseDirectories:</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-setCanChooseFiles$">-setCanChooseFiles:</a></li> <li><a rel="gsdoc" href="NSOpenPanel.html#method$NSOpenPanel-setResolvesAliases$">-setResolvesAliases:</a></li> </ul> <hr width="50%" align="left" /> <div class="method"> <h3><a name="method$NSOpenPanel+openPanel">openPanel </a></h3> + (<a rel="gsdoc" href="#class$NSOpenPanel">NSOpenPanel</a>*) <b>openPanel</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Creates (if needed) and returns the shared NSOpenPanel instance. </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-URLs">URLs </a></h3> - (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*) <b>URLs</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.0.0</div> <br /> <div class="desc"> Returns an array of the selected files as URLs </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-allowsMultipleSelection">allowsMultipleSelection </a></h3> - (BOOL) <b>allowsMultipleSelection</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Returns <code>YES</code> if the user is allowed to select multiple files. The default behavior is not to allow mutiple selections. </p> <p> </p> <p> See Also: <a rel="gsdoc" href="#method$NSOpenPanel-setAllowsMultipleSelection$"> -setAllowsMultipleSelection: </a> <a rel="gsdoc" href="NSBrowser.html#method$NSBrowser-allowsMultipleSelection">[NSBrowser -allowsMultipleSelection]</a> </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-beginForDirectory$file$types$modelessDelegate$didEndSelector$contextInfo$">beginForDirectory: file: types: modelessDelegate: didEndSelector: contextInfo: </a></h3> - (void) <b>beginForDirectory:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)path<b> file:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)filename<b> types:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)fileTypes<b> modelessDelegate:</b> (id)modelessDelegate<b> didEndSelector:</b> (SEL)didEndSelector<b> contextInfo:</b> (void*)contextInfo;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.3.0</div> <br /> <div class="desc"> <em>Description forthcoming.</em> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-beginSheetForDirectory$file$types$modalForWindow$modalDelegate$didEndSelector$contextInfo$">beginSheetForDirectory: file: types: modalForWindow: modalDelegate: didEndSelector: contextInfo: </a></h3> - (void) <b>beginSheetForDirectory:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)path<b> file:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)name<b> types:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)fileTypes<b> modalForWindow:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)docWindow<b> modalDelegate:</b> (id)delegate<b> didEndSelector:</b> (SEL)didEndSelector<b> contextInfo:</b> (void*)contextInfo;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.0.0</div> <br /> <div class="desc"> <em>Description forthcoming.</em> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-canChooseDirectories">canChooseDirectories </a></h3> - (BOOL) <b>canChooseDirectories</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Returns <code>YES</code> if the user is allowed to choose directories The default behavior is to allow choosing directories. </p> <p> </p> <p> See Also: <a rel="gsdoc" href="#method$NSOpenPanel-setCanChooseDirectories$"> -setCanChooseDirectories: </a> </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-canChooseFiles">canChooseFiles </a></h3> - (BOOL) <b>canChooseFiles</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Returns <code>YES</code> if the user is allowed to choose files. The default behavior it to allow choosing files. </p> <p> </p> <p> See Also: <a rel="gsdoc" href="#method$NSOpenPanel-setCanChooseFiles$"> -setCanChooseFiles: </a> </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-filenames">filenames </a></h3> - (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*) <b>filenames</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Returns an array containing the absolute paths (as NSString objects) of the selected files and directories. If multiple selections aren't allowed, the array contains a single name. </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-resolvesAliases">resolvesAliases </a></h3> - (BOOL) <b>resolvesAliases</b>;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.1.0</div> <br /> <div class="desc"> <em>Description forthcoming.</em> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-runModalForDirectory$file$types$">runModalForDirectory: file: types: </a></h3> - (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>runModalForDirectory:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)path<b> file:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)name<b> types:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)fileTypes;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Displays the open panel in a modal session, with the directory <var>path</var> shown and file <var>name</var> (if any) selected. Files are filtered for the specified types. If the directory is <code>nil</code>, then the directory shown in the open panel is the last directory selected. </p> <p> </p> <p> See Also: <a rel="gsdoc" href="#method$NSOpenPanel-runModalForTypes$"> -runModalForTypes: </a> </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-runModalForDirectory$file$types$relativeToWindow$">runModalForDirectory: file: types: relativeToWindow: </a></h3> - (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>runModalForDirectory:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)path<b> file:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)name<b> types:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)fileTypes<b> relativeToWindow:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)window;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.0.0</div> <br /> <div class="desc"> <em>Description forthcoming.</em> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-runModalForTypes$">runModalForTypes: </a></h3> - (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>runModalForTypes:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)fileTypes;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Displays the open panel in a modal session, showing the current directory (or last selected), and filtering for files that have the specified types. </p> <p> </p> <p> See Also: <a rel="gsdoc" href="#method$NSOpenPanel-runModalForDirectory$file$types$">-runModalForDirectory:file:types:</a> </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-setAllowsMultipleSelection$">setAllowsMultipleSelection: </a></h3> - (void) <b>setAllowsMultipleSelection:</b> (BOOL)flag;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Allows the user to select multiple files if <var>flag</var> is <code>YES</code>. The default behavior is not to allow multiple selections </p> <p> </p> <p> See Also: <a rel="gsdoc" href="#method$NSOpenPanel-allowsMultipleSelection"> -allowsMultipleSelection </a> [NSBrowser -setAllowsMultipleSelection:] </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-setCanChooseDirectories$">setCanChooseDirectories: </a></h3> - (void) <b>setCanChooseDirectories:</b> (BOOL)flag;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Allows the user to choose directories if <var>flag</var> is <code>YES</code>. The default behavior is to allow choosing directories. </p> <p> </p> <p> See Also: <a rel="gsdoc" href="#method$NSOpenPanel-canChooseDirectories"> -canChooseDirectories </a> [NSBrowser -setAllowsBranchSelection:] </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-setCanChooseFiles$">setCanChooseFiles: </a></h3> - (void) <b>setCanChooseFiles:</b> (BOOL)flag;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> </p> <p> Allows the user to choose files if <var>flag</var> is <code>YES</code>.The default behavior it to allow choosing files. </p> <p> </p> <p> See Also: <a rel="gsdoc" href="#method$NSOpenPanel-canChooseFiles"> -canChooseFiles </a> </p> <p> </div> <hr width="25%" align="left" /> </div> <div class="method"> <h3><a name="method$NSOpenPanel-setResolvesAliases$">setResolvesAliases: </a></h3> - (void) <b>setResolvesAliases:</b> (BOOL)flag;<br /> <div class="availability"> <b>Availability:</b> MacOS-X 10.1.0</div> <br /> <div class="desc"> <em>Description forthcoming.</em> </div> <hr width="25%" align="left" /> </div> <a name="_NSOpenPanel_ivars"/> <br/><hr width="50%" align="left" /> <h2>Instance Variables for NSOpenPanel Class</h2> <h3><a name="ivariable$NSOpenPanel*_canChooseDirectories">_canChooseDirectories</a></h3> @protected BOOL <b>_canChooseDirectories</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> <em>Warning</em> the underscore at the start of the name of this instance variable indicates that, even though it is not technically <em>private</em>, it is intended for internal use within the package, and you should not use the variable in other code. </div> <hr width="25%" align="left" /> <h3><a name="ivariable$NSOpenPanel*_canChooseFiles">_canChooseFiles</a></h3> @protected BOOL <b>_canChooseFiles</b>;<br /> <div class="availability"> <b>Availability:</b> OpenStep</div> <br /> <div class="desc"> <em>Warning</em> the underscore at the start of the name of this instance variable indicates that, even though it is not technically <em>private</em>, it is intended for internal use within the package, and you should not use the variable in other code. </div> <hr width="25%" align="left" /> <br/><hr width="50%" align="left" /><br/> <br /> <a href="Gui.html">Up</a> </font> </body> </html>