Server : Apache/2.4.41 (Ubuntu) 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 :
Current File : //usr/share/GNUstep/Documentation/Developer/Gui/Reference/NSApplication.html
<!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>NSApplication</title>
</head>
<body>
<font face="serif">
<a href="Gui.html">Up</a>
<br />
<h1><a name="title$NSApplication">NSApplication</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>Felipe A. Rodriguez (<a href="mailto:far@ix.netcom.com"><code>far@ix.netcom.com</code></a>)</dt>
<dd>
</dd>
<dt>Richard Frith-Macdonald (<a href="mailto:richard@brainstorm.co.uk"><code>richard@brainstorm.co.uk</code></a>)</dt>
<dd>
</dd>
</dl>
<blockquote>
The one and only application class.
</blockquote>
<p><b>Copyright:</b> (C) 1996-2105 Free Software Foundation, Inc.</p>
<div>
<hr width="50%" align="left" />
<h3>Contents -</h3>
<ol>
<li>
<a href="#001000000000">Software documentation for the NSApplication class</a>
</li>
<li>
<a href="#002000000000">Software documentation for the
NSApplication(CharacterPanel)
category</a>
</li>
<li>
<a href="#003000000000">Software documentation for the
NSApplication(GSGUIInternal)
category</a>
</li>
<li>
<a href="#004000000000">Software documentation for the
NSObject(NSApplicationDelegate)
informal protocol</a>
</li>
<li>
<a href="#005000000000">Software documentation for the
NSObject(NSServicesRequests)
informal protocol</a>
</li>
<li>
<a href="#006000000000">Software documentation for the NSApplicationDelegate
protocol</a>
</li>
</ol>
<hr width="50%" align="left" />
</div>
<h1><a name="001000000000">
Software documentation for the NSApplication class
</a></h1>
<h2><a name="class$NSApplication">NSApplication</a> : <a rel="gsdoc" href="NSResponder.html#class$NSResponder">NSResponder</a></h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSApplication.h</dd>
</dl>
</blockquote>
<blockquote>
<dl>
<dt><b>Conforms to:</b></dt>
<dd><a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSObject.html#protocol$(NSCoding)">NSCoding</a></dd>
<dd>NSUserInterfaceValidations</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Every graphical GNUstep application has exactly one
instance of <code>NSApplication</code> (or a
subclass) instantiated. Usually this is created
through the
<a rel="gsdoc" href="#method$NSApplication+sharedApplication">
+sharedApplication
</a>
method. Once created, this instance is always
accessible through the global variable '
<code>NSApp</code> '.
</p>
<p>
</p>
<p>
The NSApplication instance manages the main run loop,
dispatches events, and manages resources. It
sets up the connection to the window server and
provides special methods for putting up "modal"
(always on top) windows.
</p>
<p>
</p>
<p>
Typically,
<a rel="gsdoc" href="#method$NSApplication-run">
-run
</a>
is called by an application's <code>main</code> method
after the NSApplication instance is created, which
never returns. However, applications needing to
integrate other event loops may strategically
call the <a rel="gsdoc" href="#method$NSApplication-stop$">-stop:</a>
method, followed by
<a rel="gsdoc" href="#method$NSApplication-run">
-run
</a>
later on.
</p>
<p>
</p>
<p>
To avoid most common needs for subclassing,
NSApplication allows you to specify a
<em>delegate</em> that is messaged in particular
situations. See
<a rel="gsdoc" href="#method$NSApplication-delegate">
-delegate
</a>
,
<a rel="gsdoc" href="#method$NSApplication-setDelegate$">
-setDelegate:
</a>
, and
<a rel="gsdoc" href="#protocol$(NSApplicationDelegate)"><NSApplicationDelegate></a>
. </p>
<p>
</p>
<p>
<strong>Subclassing</strong> should be a last
resort, and delegate methods should be used in
most cases. However, subclassing is most frequently
done to implement custom event loop management by
overriding
<a rel="gsdoc" href="#method$NSApplication-run">
-run
</a>
when the method described above is not sufficient,
or to intercept events by overriding
<a rel="gsdoc" href="#method$NSApplication-sendEvent$">
-sendEvent:
</a>
.
</p>
<p>
</div>
<hr width="50%" align="left" />
<a href="#_NSApplication_ivars">Instance Variables</a>
<br/><br/>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication(CharacterPanel)-orderFrontCharacterPalette$">-orderFrontCharacterPalette:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication(GSGUIInternal)-_windowWillDealloc$">-_windowWillDealloc:</a></li>
<li><a rel="gsdoc" href="NSColorPanel.html#method$NSApplication(NSColorPanel)-orderFrontColorPanel$">-orderFrontColorPanel:</a></li>
<li><a rel="gsdoc" href="NSDataLinkPanel.html#method$NSApplication(NSDataLinkPanel)-orderFrontDataLinkPanel$">-orderFrontDataLinkPanel:</a></li>
<li><a rel="gsdoc" href="NSHelpManager.html#method$NSApplication(NSHelpManager)-activateContextHelpMode$">-activateContextHelpMode:</a></li>
<li><a rel="gsdoc" href="NSHelpManager.html#method$NSApplication(NSHelpManager)-showHelp$">-showHelp:</a></li>
<li><a rel="gsdoc" href="NSHelpPanel.html#method$NSApplication(NSHelpPanel)-orderFrontHelpPanel$">-orderFrontHelpPanel:</a></li>
<li><a rel="gsdoc" href="NSPageLayout.html#method$NSApplication(NSPageLayout)-runPageLayout$">-runPageLayout:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication+detachDrawingThread$toTarget$withObject$">+detachDrawingThread:toTarget:withObject:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication+sharedApplication">+sharedApplication</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-abortModal">-abortModal</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-activateIgnoringOtherApps$">-activateIgnoringOtherApps:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-addWindowsItem$title$filename$">-addWindowsItem:title:filename:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-applicationIconImage">-applicationIconImage</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-arrangeInFront$">-arrangeInFront:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-beginModalSessionForWindow$">-beginModalSessionForWindow:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-beginSheet$modalForWindow$modalDelegate$didEndSelector$contextInfo$">-beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-cancelUserAttentionRequest$">-cancelUserAttentionRequest:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-changeWindowsItem$title$filename$">-changeWindowsItem:title:filename:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-context">-context</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-currentEvent">-currentEvent</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-currentPresentationOptions">-currentPresentationOptions</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-deactivate">-deactivate</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-delegate">-delegate</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-discardEventsMatchingMask$beforeEvent$">-discardEventsMatchingMask:beforeEvent:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-endModalSession$">-endModalSession:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-endSheet$">-endSheet:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-endSheet$returnCode$">-endSheet:returnCode:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-finishLaunching">-finishLaunching</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-hide$">-hide:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-hideOtherApplications$">-hideOtherApplications:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-isActive">-isActive</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-isHidden">-isHidden</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-isRunning">-isRunning</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-keyWindow">-keyWindow</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-mainMenu">-mainMenu</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-mainWindow">-mainWindow</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-makeWindowsPerform$inOrder$">-makeWindowsPerform:inOrder:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-miniaturizeAll$">-miniaturizeAll:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-modalWindow">-modalWindow</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-nextEventMatchingMask$untilDate$inMode$dequeue$">-nextEventMatchingMask:untilDate:inMode:dequeue:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-orderFrontStandardAboutPanel$">-orderFrontStandardAboutPanel:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-orderFrontStandardAboutPanelWithOptions$">-orderFrontStandardAboutPanelWithOptions:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-orderFrontStandardInfoPanel$">-orderFrontStandardInfoPanel:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-orderFrontStandardInfoPanelWithOptions$">-orderFrontStandardInfoPanelWithOptions:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-orderedDocuments">-orderedDocuments</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-orderedWindows">-orderedWindows</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-postEvent$atStart$">-postEvent:atStart:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-presentationOptions">-presentationOptions</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-preventWindowOrdering">-preventWindowOrdering</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-registerServicesMenuSendTypes$returnTypes$">-registerServicesMenuSendTypes:returnTypes:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-removeWindowsItem$">-removeWindowsItem:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-replyToApplicationShouldTerminate$">-replyToApplicationShouldTerminate:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-replyToOpenOrPrint$">-replyToOpenOrPrint:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-reportException$">-reportException:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-requestUserAttention$">-requestUserAttention:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-run">-run</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-runModalForWindow$">-runModalForWindow:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-runModalForWindow$relativeToWindow$">-runModalForWindow:relativeToWindow:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-runModalSession$">-runModalSession:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-sendAction$to$from$">-sendAction:to:from:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-sendEvent$">-sendEvent:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-servicesMenu">-servicesMenu</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-servicesProvider">-servicesProvider</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setAppleMenu$">-setAppleMenu:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setApplicationIconImage$">-setApplicationIconImage:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setDelegate$">-setDelegate:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setMainMenu$">-setMainMenu:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setPresentationOptions$">-setPresentationOptions:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setServicesMenu$">-setServicesMenu:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setServicesProvider$">-setServicesProvider:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setWindowsMenu$">-setWindowsMenu:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-setWindowsNeedUpdate$">-setWindowsNeedUpdate:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-stop$">-stop:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-stopModal">-stopModal</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-stopModalWithCode$">-stopModalWithCode:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-targetForAction$">-targetForAction:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-targetForAction$to$from$">-targetForAction:to:from:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-terminate$">-terminate:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-tryToPerform$with$">-tryToPerform:with:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-unhide$">-unhide:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-unhideAllApplications$">-unhideAllApplications:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-unhideWithoutActivation">-unhideWithoutActivation</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-updateWindows">-updateWindows</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-updateWindowsItem$">-updateWindowsItem:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-validRequestorForSendType$returnType$">-validRequestorForSendType:returnType:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-windowWithWindowNumber$">-windowWithWindowNumber:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-windows">-windows</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication-windowsMenu">-windowsMenu</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSApplication+detachDrawingThread$toTarget$withObject$">detachDrawingThread: toTarget: withObject: </a></h3>
+ (void) <b>detachDrawingThread:</b> (SEL)selector<b> toTarget:</b> (id)target<b> withObject:</b> (id)argument;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Calls
<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSThread.html#method$NSThread+detachNewThreadSelector$toTarget$withObject$">[NSThread +detachNewThreadSelector:toTarget:withObject:]</a>
with the invocation wrapped by an autorelease pool.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication+sharedApplication">sharedApplication </a></h3>
+ (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*) <b>sharedApplication</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Return the shared application instance, creating
one (of the receiver class) if needed. There is (and
must always be) only a single shared application
instance for each application. After the shared
application instance has been created, you
can access it directly via the global variable
<code>NSApp</code> (but not before!). When the
shared application instance is created, it is also
automatically initialized (that is, its
<code>init</code> method is called), which
connects to the window server and prepares the
gui library for actual operation. For this reason,
you must always call
<code>[NSApplication sharedApplication]</code>
before using any functionality of the gui library
- so, normally, this should be one of the first
commands in your program (if you use
<code>
<a rel="gsdoc" href="Functions.html#function$NSApplicationMain">
NSApplicationMain()
</a>
</code>
, this is automatically done).
</p>
<p>
</p>
<p>
The shared application instance is normally an
instance of NSApplication; but you can subclass
NSApplication, and have an instance of
your own subclass be created and used as the shared
application instance. If you want to get this
result, you need to make sure the first time you
call
<a rel="gsdoc" href="#method$NSApplication+sharedApplication">
+sharedApplication
</a>
is on your custom NSApplication subclass (rather than
on NSApplication). Putting
<code>
[MyApplicationClass
sharedApplication]
</code>
; as the first command in your program is the
recommended way. :-) If you use
<code>
<a rel="gsdoc" href="Functions.html#function$NSApplicationMain">
NSApplicationMain()
</a>
</code>
, it automatically creates the appropriate instance
(which you can control by editing the info
dictionary of the application).
</p>
<p>
</p>
<p>
It is not safe to call this method from multiple
threads - it would be useless anyway since the
whole library is not thread safe: there must always
be at most one thread using the gui library at a time.
(If you absolutely need to have multiple threads in
your application, make sure only one of them uses
the gui [the 'drawing' thread], and the other ones do
not).
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-abortModal">abortModal </a></h3>
- (void) <b>abortModal</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Halts a currently running modal event loop started by
<a rel="gsdoc" href="#method$NSApplication-runModalForWindow$">
-runModalForWindow:
</a>
or
<a rel="gsdoc" href="#method$NSApplication-runModalSession$">
-runModalSession:
</a>
. If you wish to halt the session in response to user
interaction with the modal window, use
<a rel="gsdoc" href="#method$NSApplication-stopModalWithCode$">
-stopModalWithCode:
</a>
or <a rel="gsdoc" href="#method$NSApplication-stopModal">-stopModal</a>
instead; only use this to halt the loop from
elsewhere, such as another thread.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-activateIgnoringOtherApps$">activateIgnoringOtherApps: </a></h3>
- (void) <b>activateIgnoringOtherApps:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Activate app unconditionally if <var>flag</var> is
<code>YES</code>, otherwise only if no other app is
active. (
<em>
<strong>Note:</strong> this is currently not
implemented under GNUstep. The app is always
activated unconditionally.
</em>
) Usually it is not necessary to manually call this
method, except in some circumstances of
interapplication communication.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-addWindowsItem$title$filename$">addWindowsItem: title: filename: </a></h3>
- (void) <b>addWindowsItem:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)aWindow<b> title:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)aString<b> filename:</b> (BOOL)isFilename;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Adds an item to the app's Windows menu. This is
usually done automatically so you don't need to
call this method.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-applicationIconImage">applicationIconImage </a></h3>
- (<a rel="gsdoc" href="NSImage.html#class$NSImage">NSImage</a>*) <b>applicationIconImage</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Returns the current icon be used for the
application.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-setApplicationIconImage$">
-setApplicationIconImage:
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-arrangeInFront$">arrangeInFront: </a></h3>
- (void) <b>arrangeInFront:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Arranges all non-miniaturized app's windows in
front by successively calling
<a rel="gsdoc" href="NSWindow.html#method$NSWindow-orderFront$">
[NSWindow -orderFront:]
</a>
on each window in the app's Windows menu.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-beginModalSessionForWindow$">beginModalSessionForWindow: </a></h3>
- (<a rel="gsdoc" href="TypesAndConstants.html#type$NSModalSession">NSModalSession</a>) <b>beginModalSessionForWindow:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)theWindow;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Set up modal session for <var>theWindow</var>, and, if
it is not visible already, puts it up on screen,
centering it if it is an NSPanel. It is then
ordered front and made key or main window.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-beginSheet$modalForWindow$modalDelegate$didEndSelector$contextInfo$">beginSheet: modalForWindow: modalDelegate: didEndSelector: contextInfo: </a></h3>
- (void) <b>beginSheet:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)sheet<b> modalForWindow:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)docWindow<b> modalDelegate:</b> (id)modalDelegate<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">
Put up a modal <var>sheet</var> sliding down from top
of <var>docWindow</var>. If <var>modalDelegate</var> is
non-nil and responds to <var>didEndSelector</var>
(this is optional), it is invoked after the session
ends. The selector should take three arguments:
NSWindow *, <strong>int</strong>,
<strong>void</strong> *. It is passed the
<var>sheet</var> window, the return code, and the
<var>contextInfo</var> passed in here.
<em>
Under GNUstep, the <var>sheet</var> aspect is not
implemented (just centers window on the
screen), but <var>modalDelegate</var>
<var>didEndSelector</var> is called if both
non-nil.
</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-cancelUserAttentionRequest$">cancelUserAttentionRequest: </a></h3>
- (void) <b>cancelUserAttentionRequest:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)request;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Cancels a <var>request</var> previously made
through calling
<a rel="gsdoc" href="#method$NSApplication-requestUserAttention$">
-requestUserAttention:
</a>
. Note that <var>request</var> is cancelled automatically
if user activates the app.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-changeWindowsItem$title$filename$">changeWindowsItem: title: filename: </a></h3>
- (void) <b>changeWindowsItem:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)aWindow<b> title:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)aString<b> filename:</b> (BOOL)isFilename;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Changes the Window menu item associated with
<var>aWindow</var> to <var>aString</var>. If no
associated window item exists, one is created.
If <var>isFilename</var> is <code>YES</code>, then
<var>aString</var> is assumed to be a filename
representation the way
<a rel="gsdoc" href="NSWindow.html#method$NSWindow-setTitleWithRepresentedFilename$">[NSWindow -setTitleWithRepresentedFilename:]</a>
would format it, otherwise the string is displayed literally in the menu item.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-context">context </a></h3>
- (<a rel="gsdoc" href="NSGraphicsContext.html#class$NSGraphicsContext">NSGraphicsContext</a>*) <b>context</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the default drawing context for the app.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-currentEvent">currentEvent </a></h3>
- (<a rel="gsdoc" href="NSEvent.html#class$NSEvent">NSEvent</a>*) <b>currentEvent</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the most recent event
<a rel="gsdoc" href="#method$NSApplication-run">
-run
</a>
pulled off the event queue.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-currentPresentationOptions">currentPresentationOptions </a></h3>
- (<a rel="gsdoc" href="TypesAndConstants.html#type$NSApplicationPresentationOptions">NSApplicationPresentationOptions</a>) <b>currentPresentationOptions</b>;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.6.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-deactivate">deactivate </a></h3>
- (void) <b>deactivate</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Forcefully deactivate the app, without
activating another. It is rarely necessary to
use this method.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-delegate">delegate </a></h3>
- (id) <b>delegate</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the application's delegate, as set by the
<a rel="gsdoc" href="#method$NSApplication-setDelegate$">
-setDelegate:
</a>
method. <br />
</p>
<p>
The application delegate will automatically be sent
various notifications (as <strong>long</strong>
as it implements the appropriate methods) when
application events occur. The method to
handle each of these notifications has name
mirroring the notification name, so for
instance an
<em>NSApplicationDidBecomeActiveNotification</em> is
handled by an
<code>applicationDidBecomeActive:</code> method.
</p>
<p>
<ul>
<li>
NSApplicationDidBecomeActiveNotification
</li>
<li>
NSApplicationDidFinishLaunchingNotification
</li>
<li>
NSApplicationDidHideNotification
</li>
<li>
NSApplicationDidResignActiveNotification
</li>
<li>
NSApplicationDidUnhideNotification
</li>
<li>
NSApplicationDidUpdateNotification
</li>
<li>
NSApplicationWillBecomeActiveNotification
</li>
<li>
NSApplicationWillFinishLaunchingNotification
</li>
<li>
NSApplicationWillHideNotification
</li>
<li>
NSApplicationWillResignActiveNotification
</li>
<li>
NSApplicationWillTerminateNotification
</li>
<li>
NSApplicationWillUnhideNotification
</li>
<li>
NSApplicationWillUpdateNotification
</li>
</ul>
</p>
<p>
The delegate is also sent various messages to ask for
authorisation to perform actions, or to ask
it to perform actions (again, as <strong>long</strong>
as it implements the appropriate methods).
</p>
<p>
<ul>
<li>
application:shouldTerminateAfterLastWindowClosed:
</li>
<li>
application:shouldOpenUntitledFile:
</li>
<li>
application:openFile:
</li>
<li>
application:openFiles:
</li>
<li>
application:openFileWithoutUI:
</li>
<li>
application:openTempFile:
</li>
<li>
application:openUntitledFile:
</li>
<li>
application:shouldOpenUntitledFile:
</li>
<li>
application:printFile:
</li>
<li>
application:shouldTerminate:
</li>
<li>
application:shouldTerminateAfterLastWindowClosed:
</li>
</ul>
</p>
<p>
The delegate is also called upon to respond to any
actions which are not handled by a window, a
window delgate, or by the application object
itself. This is controlled by the
<a rel="gsdoc" href="#method$NSApplication-targetForAction$">
-targetForAction:
</a>
method.
</p>
<p>
</p>
<p>
Finally, the application delegate is responsible
for handling messages sent to the application from
remote processes (see the section documenting
distributed objects for
<a rel="gsdoc" href="NSPasteboard.html#class$NSPasteboard">NSPasteboard</a>
).
</p>
<p>
</p>
<p>
See
<a rel="gsdoc" href="#method$NSApplication-setDelegate$">
-setDelegate:
</a>
and
<a rel="gsdoc" href="#protocol$(NSApplicationDelegate)"><NSApplicationDelegate></a>
for more information. </p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-discardEventsMatchingMask$beforeEvent$">discardEventsMatchingMask: beforeEvent: </a></h3>
- (void) <b>discardEventsMatchingMask:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSUInteger">NSUInteger</a>)mask<b> beforeEvent:</b> (<a rel="gsdoc" href="NSEvent.html#class$NSEvent">NSEvent</a>*)lastEvent;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Drop events matching <var>mask</var> from the queue,
before but not including <var>lastEvent</var>. The
<var>mask</var> is a bitwise AND of event
<var>mask</var> constants. See (EventType). Use
<code>NSAnyEventMask</code> to discard everything up
to <var>lastEvent</var>.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-endModalSession$">endModalSession: </a></h3>
- (void) <b>endModalSession:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSModalSession">NSModalSession</a>)theSession;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Clean up after a modal session has been run. Called
with <var>theSession</var> returned from a previous
call to beginModalSessionForWindow:.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-endSheet$">endSheet: </a></h3>
- (void) <b>endSheet:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)sheet;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Analogous to
<a rel="gsdoc" href="#method$NSApplication-stopModal">
-stopModal
</a>
for sheets.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-endSheet$returnCode$">endSheet: returnCode: </a></h3>
- (void) <b>endSheet:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)sheet<b> returnCode:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)returnCode;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Analogous to
<a rel="gsdoc" href="#method$NSApplication-stopModalWithCode$">
-stopModalWithCode:
</a>
for sheets.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-finishLaunching">finishLaunching </a></h3>
- (void) <b>finishLaunching</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Activates the application, sets the application
icon, loads the main Nib file if
<code>NSMainNibFile</code> is set in the
application property list, posts an
<code>
NSApplicationWillFinishLaunchingNotification
</code>
, and takes care of a few other startup tasks. If you
override this method, be sure to call
<em>super</em>.
</p>
<p>
</p>
<p>
The <a rel="gsdoc" href="#method$NSApplication-run">-run</a>
method
calls this the first time it is called, before
starting the event loop for the first time.
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-hide$">hide: </a></h3>
- (void) <b>hide:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Request this application to "hide" (unmap all
windows from the screen except the icon window).
Posts
<code>NSApplicationWillHideNotification</code> and
<code>NSApplicationDidHideNotification</code>. On
OS X this activates the next app that is running,
however on GNUstep this is up to the window
manager.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-unhide$">
-unhide:
</a>
<a rel="gsdoc" href="#method$NSApplication-isHidden">
-isHidden
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-hideOtherApplications$">hideOtherApplications: </a></h3>
- (void) <b>hideOtherApplications:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Cause all other apps to hide themselves.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-isActive">isActive </a></h3>
- (BOOL) <b>isActive</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns whether this app is the currently active
GNUstep application. Note that on a GNUstep system,
unlike OS X, it is possible for <code>NO</code>
GNUstep app to be active.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-isHidden">isHidden </a></h3>
- (BOOL) <b>isHidden</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Returns whether app is currently in hidden state.
</p>
<p>
</p>
<p>
See Also: <a rel="gsdoc" href="#method$NSApplication-hide$">-hide:</a>
<a rel="gsdoc" href="#method$NSApplication-unhide$">
-unhide:
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-isRunning">isRunning </a></h3>
- (BOOL) <b>isRunning</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns whether the event loop managed by
<a rel="gsdoc" href="#method$NSApplication-run">
-run
</a>
is currently active.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-keyWindow">keyWindow </a></h3>
- (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*) <b>keyWindow</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns current key window. If this app is active,
one window should be key. If this app is not active,
<code>nil</code> should be returned. The key window
is the one that will receive keyboard input.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-mainMenu">mainMenu </a></h3>
- (<a rel="gsdoc" href="NSMenu.html#class$NSMenu">NSMenu</a>*) <b>mainMenu</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the main menu of the receiver.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-mainWindow">mainWindow </a></h3>
- (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*) <b>mainWindow</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns current main window of this application.
There need not necessarily be a main window, even if
app is active, and this should return <code>nil</code>
if the app is inactive.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-makeWindowsPerform$inOrder$">makeWindowsPerform: inOrder: </a></h3>
- (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*) <b>makeWindowsPerform:</b> (SEL)aSelector<b> inOrder:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sends <var>aSelector</var> to each window, either in
the app's internal window list (<var>flag</var> =
<code>NO</code>) or their stacking order from front
to back on the screen (<var>flag</var> =
<code>YES</code>,
<em>currently not implemented under GNUstep</em>).
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-miniaturizeAll$">miniaturizeAll: </a></h3>
- (void) <b>miniaturizeAll:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Iconify all windows in the app.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-modalWindow">modalWindow </a></h3>
- (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*) <b>modalWindow</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Returns the window that is part of the current
modal session, if any.
</p>
<p>
</p>
<p>
See
<a rel="gsdoc" href="#method$NSApplication-runModalForWindow$">
-runModalForWindow:
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-nextEventMatchingMask$untilDate$inMode$dequeue$">nextEventMatchingMask: untilDate: inMode: dequeue: </a></h3>
- (<a rel="gsdoc" href="NSEvent.html#class$NSEvent">NSEvent</a>*) <b>nextEventMatchingMask:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSUInteger">NSUInteger</a>)mask<b> untilDate:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSDate.html#class$NSDate">NSDate</a>*)expiration<b> inMode:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)mode<b> dequeue:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Return the next event matching <var>mask</var> from
the queue, dequeuing if <var>flag</var> is
<code>YES</code>. Intervening events are NOT
dequeued. If no matching event is on the queue,
will wait for one until <var>expiration</var>,
returning <code>nil</code> if none found. See
(EventType) for the list of masks.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-orderFrontStandardAboutPanel$">orderFrontStandardAboutPanel: </a></h3>
- (void) <b>orderFrontStandardAboutPanel:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Calls
<a rel="gsdoc" href="#method$NSApplication-orderFrontStandardAboutPanelWithOptions$">-orderFrontStandardAboutPanelWithOptions:</a>
with <code>nil</code> passed as the options dictionary.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-orderFrontStandardAboutPanelWithOptions$">orderFrontStandardAboutPanelWithOptions: </a></h3>
- (void) <b>orderFrontStandardAboutPanelWithOptions:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSDictionary.html#class$NSDictionary">NSDictionary</a>*)dictionary;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
OS X compatibility: Calls
<a rel="gsdoc" href="#method$NSApplication-orderFrontStandardInfoPanelWithOptions$">-orderFrontStandardInfoPanelWithOptions:</a>
.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-orderFrontStandardInfoPanel$">orderFrontStandardInfoPanel: </a></h3>
- (void) <b>orderFrontStandardInfoPanel:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Calls
<a rel="gsdoc" href="#method$NSApplication-orderFrontStandardInfoPanelWithOptions$">-orderFrontStandardInfoPanelWithOptions:</a>
with <code>nil</code> passed as the options dictionary.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-orderFrontStandardInfoPanelWithOptions$">orderFrontStandardInfoPanelWithOptions: </a></h3>
- (void) <b>orderFrontStandardInfoPanelWithOptions:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSDictionary.html#class$NSDictionary">NSDictionary</a>*)dictionary;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
</p>
<p>
Orders front the standard info panel for the
application, taking the needed information
from the <code><var>dictionary</var></code>
argument. There is a single standard info panel
per application; it is created the first time that
this method is invoked, and then reused in all
subsequent calls. The application standard
info panel is immutable and can not be changed after
creation. Useful keys for the
<code><var>dictionary</var></code> are:
</p>
<p>
<dl>
<dt>ApplicationName</dt>
<dd>
A string with the name of the application (eg,
<var>"Gorm"</var>). If not available, the
<code>Info-gnustep.plist</code> file is searched
for the value of <var>ApplicationName</var>
followed by
<var>NSHumanReadableShortName</var>. If this also
fails, the string returned by
<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSProcessInfo.html#method$NSProcessInfo-processName">[NSProcessInfo -processName]</a>
is used.
</dd>
<dt>ApplicationDescription</dt>
<dd>
A string with a very <strong>short</strong>
description of the application (eg,
<var>
"GNUstep Graphics Objects Relationship
Modeller"
</var>
). If not available, <code>Info-gnustep.plist</code>
is searched for that key; if this fails, no
application description is shown.
</dd>
<dt>ApplicationIcon</dt>
<dd>
An image to be shown near the title. If not
available, <code>Info-gnustep.plist</code>
is searched for <var>ApplicationIcon</var>; if this
fails, NSApp's
<a rel="gsdoc" href="#method$NSApplication-applicationIconImage">
-applicationIconImage
</a>
method is used instead.
</dd>
<dt>ApplicationRelease</dt>
<dd>
A string with the name of the application, release
included (eg, <var>"Gorm 0.1"</var>). If not
available, the value for
<var>ApplicationVersion</var> is used instead. If
this fails, <code>Info-gnustep.plist</code> is
searched for <var>ApplicationRelease</var> or
<var>NSAppVersion</var>, otherwise,
<var>"Unknown"</var> is used.
</dd>
<dt>FullVersionID</dt>
<dd>
A string with the full version of the application
(eg, <var>"0.1.2b"</var> or
<var>"snap011100"</var>). If not available,
<var>Version</var> is used instead. If this
fails, <code>Info-gnustep.plist</code> is looked
for <var>NSBuildVersion</var>. If all fails, no
full version is shown.
</dd>
<dt>Authors</dt>
<dd>
An array of strings, each one with the name of an
author (eg,
<var>
[NSArray arrayWithObject: "Nicola Pero
<n.pero\@mi.flashnet.it>"]
</var>
). If not found, <code>Info-gnustep.plist</code> is
searched for <var>Authors</var>, if this
fails, <var>"Unknown"</var> is displayed.
</dd>
<dt>URL</dt>
<dd>
[This field is still under work, so it might be
changed] A string with an URL (eg,
<var>"See http://www.gnustep.org"</var>).
</dd>
<dt>Copyright</dt>
<dd>
A string with copyright owners (eg,
<var>
"Copyright (C) 2000 The Free Software
Foundation, Inc."
</var>
). Support for multiple line strings is planned but
not yet available. If not found,
<code>Info-gnustep.plist</code> is searched for
<var>Copyright</var> and then (failing this) for
<var>NSHumanReadableCopyright</var>. If all
fails,
<var>"Copyright Information Not Available"</var>
is used.
</dd>
<dt>CopyrightDescription</dt>
<dd>
A string describing the kind of copyright (eg,
<var>
"Released under the GNU General Public
License 2.0"
</var>
). If not available, <code>Info-gnustep.plist</code>
is searched for <var>CopyrightDescription</var>. If
this fails, no copyright description is shown.
</dd>
</dl>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-orderedDocuments">orderedDocuments </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*) <b>orderedDocuments</b>;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
OS X scripting method to return document objects being
handled by application.
<em>Not implemented yet under GNUstep.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-orderedWindows">orderedWindows </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*) <b>orderedWindows</b>;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
OS X scripting method to return windows in front-to-back
on-screen order for scriptable windows.
<em>
The GNUstep implementation returns all the windows
excluding NSPanels. some backends may return an
array in an unspecified order.
</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-postEvent$atStart$">postEvent: atStart: </a></h3>
- (void) <b>postEvent:</b> (<a rel="gsdoc" href="NSEvent.html#class$NSEvent">NSEvent</a>*)event<b> atStart:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Add an <var>event</var> to be processed by the app,
either at end or at beginning (next up) if
<var>flag</var> is <code>YES</code>. This provides a
way to provide synthetic input to an application, or,
for whatever reason, to allow a real <var>event</var>
to be re-dispatched.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-presentationOptions">presentationOptions </a></h3>
- (<a rel="gsdoc" href="TypesAndConstants.html#type$NSApplicationPresentationOptions">NSApplicationPresentationOptions</a>) <b>presentationOptions</b>;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.6.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-preventWindowOrdering">preventWindowOrdering </a></h3>
- (void) <b>preventWindowOrdering</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Prevent window reordering in response to most
recent mouse down (useful to prevent
raise-on-mouse-click).
<em>Not implemented under GNUstep.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-registerServicesMenuSendTypes$returnTypes$">registerServicesMenuSendTypes: returnTypes: </a></h3>
- (void) <b>registerServicesMenuSendTypes:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)sendTypes<b> returnTypes:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)returnTypes;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Registers the types this application can send and
receive over Services. <var>sendTypes</var>
represents the pasteboard types this app can
receive in Service invocation. This is used to set
up the services menu of this app -- an item is added for
each registered service that can accept one of
<var>sendTypes</var> or return one of
<var>returnTypes</var>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-removeWindowsItem$">removeWindowsItem: </a></h3>
- (void) <b>removeWindowsItem:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)aWindow;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Removes an item from the app's Windows menu. This
is usually done automatically so you don't need to call
this method.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-replyToApplicationShouldTerminate$">replyToApplicationShouldTerminate: </a></h3>
- (void) <b>replyToApplicationShouldTerminate:</b> (BOOL)shouldTerminate;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Terminates the app if <var>shouldTerminate</var>
is <code>YES</code>, otherwise does nothing. This should
be called by user code if a delegate has returned
<code>NSTerminateLater</code> to an
<a rel="gsdoc" href="#method$NSObject(NSApplicationDelegate)-applicationShouldTerminate$">
-applicationShouldTerminate:
</a>
message.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-replyToOpenOrPrint$">replyToOpenOrPrint: </a></h3>
- (void) <b>replyToOpenOrPrint:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSApplicationDelegateReply">NSApplicationDelegateReply</a>)reply;<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$NSApplication-reportException$">reportException: </a></h3>
- (void) <b>reportException:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSException.html#class$NSException">NSException</a>*)anException;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
NSLogs an exception without raising it.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-requestUserAttention$">requestUserAttention: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>requestUserAttention:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSRequestUserAttentionType">NSRequestUserAttentionType</a>)requestType;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Method that on OS X makes the icon jump in the doc.
Mercifully, this is unimplemented under
GNUstep. If it <em>were</em> implemented,
<var>requestType</var> could be either
<code>NSCriticalRequest</code> (bounce endlessly) or
<code>NSInformationalRequest</code> (bounce for one
second).
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-run">run </a></h3>
- (void) <b>run</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
This method first calls
<a rel="gsdoc" href="#method$NSApplication-finishLaunching">
-finishLaunching
</a>
(if this is the first time -run) has been called,
then starts the main event loop of the application
which continues until
<a rel="gsdoc" href="#method$NSApplication-terminate$">
-terminate:
</a>
or <a rel="gsdoc" href="#method$NSApplication-stop$">-stop:</a>
is
called.
</p>
<p>
</p>
<p>
At each iteration, at most one event is dispatched,
the main and services menus are sent
<a rel="gsdoc" href="NSMenu.html#method$NSMenu-update">
[NSMenu -update]
</a>
messages, and
<a rel="gsdoc" href="#method$NSApplication-updateWindows">
-updateWindows
</a>
is possibly called if this has been flagged as
necessary.
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-runModalForWindow$">runModalForWindow: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>runModalForWindow:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)theWindow;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Starts modal event loop for given window, after
calling
<a rel="gsdoc" href="#method$NSApplication-beginModalSessionForWindow$">
-beginModalSessionForWindow:
</a>
. Loop is broken only by
<a rel="gsdoc" href="#method$NSApplication-stopModal">
-stopModal
</a>
,
<a rel="gsdoc" href="#method$NSApplication-stopModalWithCode$">
-stopModalWithCode:
</a>
, or
<a rel="gsdoc" href="#method$NSApplication-abortModal">
-abortModal
</a>
, at which time
<a rel="gsdoc" href="#method$NSApplication-endModalSession$">
-endModalSession:
</a>
is called automatically.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-runModalForWindow$relativeToWindow$">runModalForWindow: relativeToWindow: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>runModalForWindow:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)theWindow<b> relativeToWindow:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)docWindow;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Put up a modal window centered relative to
<var>docWindow</var>. On OS X this is deprecated in
favor of
<a rel="gsdoc" href="#method$NSApplication-beginSheet$modalForWindow$modalDelegate$didEndSelector$contextInfo$">-beginSheet:modalForWindow:modalDelegate:didEndSelector:contextInfo:</a>
.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-runModalSession$">runModalSession: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>runModalSession:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSModalSession">NSModalSession</a>)theSession;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Processes any events for a modal session
described by the <var>theSession</var>
variable. When finished, it returns the state
of the session (i.e. whether it is still running or
has been stopped, etc)
</p>
<p>
</p>
<p>
If there are no pending events for the session, this
method returns immediately.
</p>
<p>
</p>
<p>
Although Apple's docs state that, before
processing the events, it makes the session
window key and orders the window front, this
method does not attempt to do this, because: 1) we
don't want to interfere with use of other apps
during modal session for this app; 2) occasionally
other windows are active and should be usable
during modal sessions (e.g., a popup dialog from a
modal window); 3) most of the time
<a rel="gsdoc" href="#method$NSApplication-beginModalSessionForWindow$">
-beginModalSessionForWindow:
</a>
will have been called in advance. If the latter is
not the case, you may need to order the window front
yourself in advance.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-runModalForWindow$">
-runModalForWindow:
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-sendAction$to$from$">sendAction: to: from: </a></h3>
- (BOOL) <b>sendAction:</b> (SEL)aSelector<b> to:</b> (id)aTarget<b> from:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sends the <var>aSelector</var> message to the
receiver returned by the
<a rel="gsdoc" href="#method$NSApplication-targetForAction$to$from$">
-targetForAction:to:from:
</a>
method (to which the <var>aTarget</var> and
<var>sender</var> arguments are passed). <br /> The
method in the receiver must expect a single argument
... the <var>sender</var>. <br /> Any value returned by
the method in the receiver is ignored. <br /> This
method returns <code>YES</code> on success,
<code>NO</code> on failure (when no receiver can be
found for <var>aSelector</var>).
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-sendEvent$">sendEvent: </a></h3>
- (void) <b>sendEvent:</b> (<a rel="gsdoc" href="NSEvent.html#class$NSEvent">NSEvent</a>*)theEvent;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Called by <a rel="gsdoc" href="#method$NSApplication-run">-run</a>
to
dispatch events that are received according to
AppKit's forwarding conventions. You rarely need
to invoke this directly. If you want to synthesize an
event for processing, call
<a rel="gsdoc" href="#method$NSApplication-postEvent$atStart$">
-postEvent:atStart:
</a>
.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-servicesMenu">servicesMenu </a></h3>
- (<a rel="gsdoc" href="NSMenu.html#class$NSMenu">NSMenu</a>*) <b>servicesMenu</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Returns the services menu of the receiver.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-setServicesMenu$">
-setServicesMenu:
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-servicesProvider">servicesProvider </a></h3>
- (id) <b>servicesProvider</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Returns the services provided previously
registered using the
<a rel="gsdoc" href="#method$NSApplication-setServicesProvider$">
-setServicesProvider:
</a>
method.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-setServicesProvider$">
-setServicesProvider:
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setAppleMenu$">setAppleMenu: </a></h3>
- (void) <b>setAppleMenu:</b> (<a rel="gsdoc" href="NSMenu.html#class$NSMenu">NSMenu</a>*)aMenu;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Here for compatibility with OS X, but currently a
no-op.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setApplicationIconImage$">setApplicationIconImage: </a></h3>
- (void) <b>setApplicationIconImage:</b> (<a rel="gsdoc" href="NSImage.html#class$NSImage">NSImage</a>*)anImage;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Sets the application's icon. Any windows that use
the old application icon image as their mini window
image will be updated to use the new image.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-applicationIconImage">
-applicationIconImage
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setDelegate$">setDelegate: </a></h3>
- (void) <b>setDelegate:</b> (id)anObject;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets the delegate of the application to
<var>anObject</var>. <br />
</p>
<p>
<em>Beware</em>, this does not retain
<var>anObject</var>, so you must be sure that, in
the event of <var>anObject</var> being deallocated,
you stop it being the application delagate by calling
this method again with another object (or
<code>nil</code>) as the argument.
</p>
<p>
</p>
<p>
See <a rel="gsdoc" href="#method$NSApplication-delegate">-delegate</a>
and
<a rel="gsdoc" href="#protocol$(NSApplicationDelegate)"><NSApplicationDelegate></a>
for more information. </p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setMainMenu$">setMainMenu: </a></h3>
- (void) <b>setMainMenu:</b> (<a rel="gsdoc" href="NSMenu.html#class$NSMenu">NSMenu</a>*)aMenu;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets the main menu of the receiver. This is sent
update messages by the main event loop.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setPresentationOptions$">setPresentationOptions: </a></h3>
- (void) <b>setPresentationOptions:</b> (<a rel="gsdoc" href="TypesAndConstants.html#type$NSApplicationPresentationOptions">NSApplicationPresentationOptions</a>)options;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.6.0</div>
<br />
<div class="desc">
Currently unimplemented and unused in GNUstep, it
could be extended to handle special GNUstep needs too
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setServicesMenu$">setServicesMenu: </a></h3>
- (void) <b>setServicesMenu:</b> (<a rel="gsdoc" href="NSMenu.html#class$NSMenu">NSMenu</a>*)aMenu;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
ets the services menu for the receiver. This should
be called, otherwise warnings will be generated by the
main event loop, which is in charge of updating all
menus, including the Services menu.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-servicesMenu">
-servicesMenu
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setServicesProvider$">setServicesProvider: </a></h3>
- (void) <b>setServicesProvider:</b> (id)anObject;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets the object which provides services to other
applications. <br /> Passing a
<code>nil</code> value for <var>anObject</var> will
result in the provision of services to other
applications by this application being
disabled. <br /> See
<a rel="gsdoc" href="NSPasteboard.html#class$NSPasteboard">NSPasteboard</a>
for information about providing services.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setWindowsMenu$">setWindowsMenu: </a></h3>
- (void) <b>setWindowsMenu:</b> (<a rel="gsdoc" href="NSMenu.html#class$NSMenu">NSMenu</a>*)aMenu;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets the windows menu of the receiver. The windows
menu keeps track of all windows open in the
application.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-setWindowsNeedUpdate$">setWindowsNeedUpdate: </a></h3>
- (void) <b>setWindowsNeedUpdate:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Set whether the main run loop will request all visible
windows update themselves after the current or next
event is processed. (Update occurs after event
dispatch in the loop.) This is needed when in
NSEventTrackingRunLoopMode.
When the application is using NSDefaultRunLoopMode or
NSModalPanelRunLoopMode windows are
updated after each loop iteration irrespective of
this setting.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-stop$">stop: </a></h3>
- (void) <b>stop:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Stops the main run loop, as well as a modal session
if it is running.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-stopModal">stopModal </a></h3>
- (void) <b>stopModal</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Stops a running modal session causing
<a rel="gsdoc" href="#method$NSApplication-runModalForWindow$">
-runModalForWindow:
</a>
or
<a rel="gsdoc" href="#method$NSApplication-runModalSession$">
-runModalSession:
</a>
to return <code>NSRunStoppedResponse</code>. Use this
or
<a rel="gsdoc" href="#method$NSApplication-stopModalWithCode$">
-stopModalWithCode:
</a>
to end a modal session in response to user input.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-stopModalWithCode$">
-stopModalWithCode:
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-stopModalWithCode$">stopModalWithCode: </a></h3>
- (void) <b>stopModalWithCode:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)returnCode;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Stops a running modal session causing
<a rel="gsdoc" href="#method$NSApplication-runModalForWindow$">
-runModalForWindow:
</a>
or
<a rel="gsdoc" href="#method$NSApplication-runModalSession$">
-runModalSession:
</a>
to return the specified integer code. Use this or
<a rel="gsdoc" href="#method$NSApplication-stopModal">
-stopModal
</a>
to end a modal session in response to user input.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-targetForAction$">targetForAction: </a></h3>
- (id) <b>targetForAction:</b> (SEL)aSelector;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Returns the target object that will respond to
<var>aSelector</var>, if any. The method first
checks if any of the key window's first
responders, the key window or its delegate
responds. Next it checks the main window in the
same way. Finally it checks the receiver
(NSApplication) and its delegate.
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-targetForAction$to$from$">targetForAction: to: from: </a></h3>
- (id) <b>targetForAction:</b> (SEL)theAction<b> to:</b> (id)theTarget<b> from:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
If <var>theTarget</var> responds to <var>theAction</var>
it is returned, otherwise the application searches for
an object which will handle <var>theAction</var> and
returns the first object found. <br /> Returns
<code>nil</code> on failure.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-terminate$">terminate: </a></h3>
- (void) <b>terminate:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Requests the application terminates the
application. First an
<a rel="gsdoc" href="#method$NSObject(NSApplicationDelegate)-applicationShouldTerminate$">
-applicationShouldTerminate:
</a>
message is sent to the delegate, and only if it
returns <code>NSTerminateNow</code> will
termination be carried out. <br /> The old
version of
<a rel="gsdoc" href="#method$NSObject(NSApplicationDelegate)-applicationShouldTerminate$">
-applicationShouldTerminate:
</a>
returned a BOOL, and this should still work as
<code>YES</code> is equivalent to
<code>NSTerminateNow</code> and <code>NO</code> is
equivalent to <code>NSTerminateCancel</code>.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-tryToPerform$with$">tryToPerform: with: </a></h3>
- (BOOL) <b>tryToPerform:</b> (SEL)aSelector<b> with:</b> (id)anObject;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Attempts to perform <var>aSelector</var> using
<a rel="gsdoc" href="NSResponder.html#method$NSResponder-tryToPerform$with$">[NSResponder -tryToPerform:with:]</a>
and if that is not possible, attempts to get the application delegate to perform the <var>aSelector</var>. <br /> Returns <code>YES</code> if an object was found to perform <var>aSelector</var>, <code>NO</code> otherwise.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-unhide$">unhide: </a></h3>
- (void) <b>unhide:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
</p>
<p>
Unhides and activates this application.
</p>
<p>
</p>
<p>
See Also:
<a rel="gsdoc" href="#method$NSApplication-unhideWithoutActivation">
-unhideWithoutActivation
</a>
<a rel="gsdoc" href="#method$NSApplication-hide$">
-hide:
</a>
<a rel="gsdoc" href="#method$NSApplication-isHidden">
-isHidden
</a>
</p>
<p>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-unhideAllApplications$">unhideAllApplications: </a></h3>
- (void) <b>unhideAllApplications:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Cause all apps including this one to unhide
themselves.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-unhideWithoutActivation">unhideWithoutActivation </a></h3>
- (void) <b>unhideWithoutActivation</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Unhides this app (displays its windows) but does
not activate it.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-updateWindows">updateWindows </a></h3>
- (void) <b>updateWindows</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sends each of the app's visible windows an
<a rel="gsdoc" href="NSWindow.html#method$NSWindow-update">
[NSWindow -update]
</a>
message. This method is called automatically for
every iteration of the run loop in
NSDefaultRunLoopMode or
NSModalPanelRunLoopMode, but is
only called during NSEventTrackingRunLoopMode if
<a rel="gsdoc" href="#method$NSApplication-setWindowsNeedUpdate$">
-setWindowsNeedUpdate:
</a>
is set to <code>YES</code>.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-updateWindowsItem$">updateWindowsItem: </a></h3>
- (void) <b>updateWindowsItem:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)aWindow;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Update Windows menu item for <var>aWindow</var>, to
reflect its edited status. This is usually done
automatically so you don't need to call this.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-validRequestorForSendType$returnType$">validRequestorForSendType: returnType: </a></h3>
- (id) <b>validRequestorForSendType:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)sendType<b> returnType:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)returnType;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Return an object capable of sending and receiving
the specified <var>sendType</var> and
<var>returnType</var> in a services interaction.
NSApp is generally the last responder to get this
request, and the implementation passes it on to
the delegate if it handles it and is not itself an
<a rel="gsdoc" href="NSResponder.html#class$NSResponder">NSResponder</a>
, or returns <code>nil</code> otherwise.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-windowWithWindowNumber$">windowWithWindowNumber: </a></h3>
- (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*) <b>windowWithWindowNumber:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)windowNum;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns window for <var>windowNum</var>. Note the
window number can be obtained for a window from
<a rel="gsdoc" href="NSWindow.html#method$NSWindow-windowNumber">
[NSWindow -windowNumber]
</a>
.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-windows">windows </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*) <b>windows</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns array of app's visible and invisible
windows.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSApplication-windowsMenu">windowsMenu </a></h3>
- (<a rel="gsdoc" href="NSMenu.html#class$NSMenu">NSMenu</a>*) <b>windowsMenu</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns current Windows menu for the application
(whose window contents are managed automatically by
this class and NSWindow).
</div>
<hr width="25%" align="left" />
</div>
<a name="_NSApplication_ivars"/> <br/><hr width="50%" align="left" />
<h2>Instance Variables for NSApplication Class</h2>
<h3><a name="ivariable$NSApplication*_app_icon">_app_icon</a></h3>
@protected NSImage* <b>_app_icon</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$NSApplication*_app_icon_window">_app_icon_window</a></h3>
@protected NSWindow* <b>_app_icon_window</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$NSApplication*_app_is_active">_app_is_active</a></h3>
@protected BOOL <b>_app_is_active</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$NSApplication*_app_is_hidden">_app_is_hidden</a></h3>
@protected BOOL <b>_app_is_hidden</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$NSApplication*_app_is_launched">_app_is_launched</a></h3>
@protected BOOL <b>_app_is_launched</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$NSApplication*_app_is_running">_app_is_running</a></h3>
@protected BOOL <b>_app_is_running</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$NSApplication*_current_event">_current_event</a></h3>
@protected NSEvent* <b>_current_event</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$NSApplication*_default_context">_default_context</a></h3>
@protected NSGraphicsContext* <b>_default_context</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$NSApplication*_delegate">_delegate</a></h3>
@protected id <b>_delegate</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$NSApplication*_hidden">_hidden</a></h3>
@protected NSMutableArray* <b>_hidden</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$NSApplication*_hidden_key">_hidden_key</a></h3>
@protected NSWindow* <b>_hidden_key</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$NSApplication*_hidden_main">_hidden_main</a></h3>
@protected NSWindow* <b>_hidden_main</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$NSApplication*_inactive">_inactive</a></h3>
@protected NSMutableArray* <b>_inactive</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$NSApplication*_infoPanel">_infoPanel</a></h3>
@protected GSInfoPanel* <b>_infoPanel</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$NSApplication*_key_window">_key_window</a></h3>
@protected NSWindow* <b>_key_window</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$NSApplication*_listener">_listener</a></h3>
@protected id <b>_listener</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$NSApplication*_main_menu">_main_menu</a></h3>
@protected NSMenu* <b>_main_menu</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$NSApplication*_main_window">_main_window</a></h3>
@protected NSWindow* <b>_main_window</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$NSApplication*_presentationOptions">_presentationOptions</a></h3>
@protected NSApplicationPresentationOptions <b>_presentationOptions</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$NSApplication*_runLoopPool">_runLoopPool</a></h3>
@protected id <b>_runLoopPool</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$NSApplication*_session">_session</a></h3>
@protected NSModalSession <b>_session</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$NSApplication*_unhide_on_activation">_unhide_on_activation</a></h3>
@protected BOOL <b>_unhide_on_activation</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$NSApplication*_windows_menu">_windows_menu</a></h3>
@protected NSMenu* <b>_windows_menu</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$NSApplication*_windows_need_update">_windows_need_update</a></h3>
@protected BOOL <b>_windows_need_update</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/>
<h1><a name="002000000000">
Software documentation for the
NSApplication(CharacterPanel)
category
</a></h1>
<h2><a rel="gsdoc" href="#class$NSApplication">NSApplication</a>(<a name="category$NSApplication(CharacterPanel)">CharacterPanel</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSApplication.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication(CharacterPanel)-orderFrontCharacterPalette$">-orderFrontCharacterPalette:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSApplication(CharacterPanel)-orderFrontCharacterPalette$">orderFrontCharacterPalette: </a></h3>
- (void) <b>orderFrontCharacterPalette:</b> (id)sender;<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>
<h1><a name="003000000000">
Software documentation for the
NSApplication(GSGUIInternal)
category
</a></h1>
<h2><a rel="gsdoc" href="#class$NSApplication">NSApplication</a>(<a name="category$NSApplication(GSGUIInternal)">GSGUIInternal</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSApplication.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSApplication.html#method$NSApplication(GSGUIInternal)-_windowWillDealloc$">-_windowWillDealloc:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSApplication(GSGUIInternal)-_windowWillDealloc$">_windowWillDealloc: </a></h3>
- (void) <b>_windowWillDealloc:</b> (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*)window;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
<em>Warning</em> the underscore at the start of the
name of this method indicates that it is private, for
internal use only, and you should not use the
method in your code.
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="004000000000">
Software documentation for the
NSObject(NSApplicationDelegate)
informal protocol
</a></h1>
<h2><a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSObject.html#class$NSObject">NSObject</a>(<a name="category$NSObject(NSApplicationDelegate)">NSApplicationDelegate</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSApplication.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$delegateHandlesKey$">-application:delegateHandlesKey:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$openFile$">-application:openFile:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$openFileWithoutUI$">-application:openFileWithoutUI:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$openFiles$">-application:openFiles:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$openTempFile$">-application:openTempFile:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$printFile$">-application:printFile:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$printFiles$">-application:printFiles:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$printFiles$withSettings$showPrintPanels$">-application:printFiles:withSettings:showPrintPanels:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-application$willPresentError$">-application:willPresentError:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationDidBecomeActive$">-applicationDidBecomeActive:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationDidChangeScreenParameters$">-applicationDidChangeScreenParameters:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationDidFinishLaunching$">-applicationDidFinishLaunching:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationDidHide$">-applicationDidHide:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationDidResignActive$">-applicationDidResignActive:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationDidUnhide$">-applicationDidUnhide:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationDidUpdate$">-applicationDidUpdate:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationDockMenu$">-applicationDockMenu:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationOpenUntitledFile$">-applicationOpenUntitledFile:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationShouldHandleReopen$hasVisibleWindows$">-applicationShouldHandleReopen:hasVisibleWindows:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationShouldOpenUntitledFile$">-applicationShouldOpenUntitledFile:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationShouldTerminate$">-applicationShouldTerminate:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationShouldTerminateAfterLastWindowClosed$">-applicationShouldTerminateAfterLastWindowClosed:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationWillBecomeActive$">-applicationWillBecomeActive:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationWillFinishLaunching$">-applicationWillFinishLaunching:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationWillHide$">-applicationWillHide:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationWillResignActive$">-applicationWillResignActive:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationWillTerminate$">-applicationWillTerminate:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationWillUnhide$">-applicationWillUnhide:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSApplicationDelegate)-applicationWillUpdate$">-applicationWillUpdate:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-application$delegateHandlesKey$">application: delegateHandlesKey: </a></h3>
- (BOOL) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)sender<b> delegateHandlesKey:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)key;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Method called by scripting framework on OS X.
<em>Not implemented (sent) yet on GNUstep.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-application$openFile$">application: openFile: </a></h3>
- (BOOL) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)app<b> openFile:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)filename;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Sender requests application to open
<var>filename</var>. <code>YES</code> should be
returned on success, <code>NO</code> on failure.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-application$openFileWithoutUI$">application: openFileWithoutUI: </a></h3>
- (BOOL) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)app<b> openFileWithoutUI:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)filename;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Sender <var>app</var> (not necessarily this
application) requests application to open file
without bringing up its normal UI, for programmatic
manipulation. <code>YES</code> should be
returned on success, <code>NO</code> on failure.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-application$openFiles$">application: openFiles: </a></h3>
- (void) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)app<b> openFiles:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)filenames;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.3.0</div>
<br />
<div class="desc">
Sender requests application to open
<var>filenames</var>.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-application$openTempFile$">application: openTempFile: </a></h3>
- (BOOL) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)app<b> openTempFile:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)filename;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Sender requests application to open a temporary
file. Responsibility for eventual deletion lies with
this application. <code>YES</code> should be returned
on success, <code>NO</code> on failure.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-application$printFile$">application: printFile: </a></h3>
- (BOOL) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)theApplication<b> printFile:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)filename;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Sender requests application to print
<var>filename</var>. This should generally be done
without presenting a GUI to the user, unless
default options are likely to be changed.
<code>YES</code> should be returned on success,
<code>NO</code> on failure.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-application$printFiles$">application: printFiles: </a></h3>
- (void) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)app<b> printFiles:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)filenames;<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$NSObject(NSApplicationDelegate)-application$printFiles$withSettings$showPrintPanels$">application: printFiles: withSettings: showPrintPanels: </a></h3>
- (<a rel="gsdoc" href="TypesAndConstants.html#type$NSApplicationPrintReply">NSApplicationPrintReply</a>) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)app<b> printFiles:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)files<b> withSettings:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSDictionary.html#class$NSDictionary">NSDictionary</a>*)settings<b> showPrintPanels:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.4.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-application$willPresentError$">application: willPresentError: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSError.html#class$NSError">NSError</a>*) <b>application:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)app<b> willPresentError:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSError.html#class$NSError">NSError</a>*)error;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.4.0</div>
<br />
<div class="desc">
Ask delegate for an <var>error</var> replacement.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationDidBecomeActive$">applicationDidBecomeActive: </a></h3>
- (void) <b>applicationDidBecomeActive:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application has become
active.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationDidChangeScreenParameters$">applicationDidChangeScreenParameters: </a></h3>
- (void) <b>applicationDidChangeScreenParameters:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Called on OS X when the resolution or other
characteristics of the display have changed
(through control panel operation, connecting a new
monitor, etc.).
<em>Not implemented/sent yet under GNUstep.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationDidFinishLaunching$">applicationDidFinishLaunching: </a></h3>
- (void) <b>applicationDidFinishLaunching:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application has
finished launching
([NSApplication-finishLaunching]
has completed, but no event dispatching has begun.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationDidHide$">applicationDidHide: </a></h3>
- (void) <b>applicationDidHide:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application has just
been hidden.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationDidResignActive$">applicationDidResignActive: </a></h3>
- (void) <b>applicationDidResignActive:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application has just
been deactivated.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationDidUnhide$">applicationDidUnhide: </a></h3>
- (void) <b>applicationDidUnhide:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application has just
been unhidden.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationDidUpdate$">applicationDidUpdate: </a></h3>
- (void) <b>applicationDidUpdate:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application has
updated its windows.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationDockMenu$">applicationDockMenu: </a></h3>
- (<a rel="gsdoc" href="NSMenu.html#class$NSMenu">NSMenu</a>*) <b>applicationDockMenu:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)sender;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.1.0</div>
<br />
<div class="desc">
Method used on OS X to allow an application to
override the standard menu obtained by
right-clicking on the application's dock
icon.
<em>
Called when the application uses Macintosh or
Windows95 style menus.
</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationOpenUntitledFile$">applicationOpenUntitledFile: </a></h3>
- (BOOL) <b>applicationOpenUntitledFile:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)app;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Sender requests application to open a fresh
document. <code>YES</code> should be returned on
success, <code>NO</code> on failure.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationShouldHandleReopen$hasVisibleWindows$">applicationShouldHandleReopen: hasVisibleWindows: </a></h3>
- (BOOL) <b>applicationShouldHandleReopen:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)theApplication<b> hasVisibleWindows:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Method used on OS X to allow delegate to handle
event when user clicks on dock icon of an
already-open app. If <code>YES</code> is
returned, a default implementation executes (for
example, to create a new untitled document); if
<code>NO</code> is returned nothing is done (and you
can handle it here in this method).
<em>Not sent yet under GNUstep.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationShouldOpenUntitledFile$">applicationShouldOpenUntitledFile: </a></h3>
- (BOOL) <b>applicationShouldOpenUntitledFile:</b> (<a rel="gsdoc" href="#class$NSApplication">NSApplication</a>*)sender;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Sender will request application to open a fresh
document, unless <code>NO</code> is returned
here.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationShouldTerminate$">applicationShouldTerminate: </a></h3>
- (BOOL) <b>applicationShouldTerminate:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Sent from within the
<a rel="gsdoc" href="#method$NSApplication-terminate$">
[NSApplication -terminate:]
</a>
. If <code>NO</code> is returned termination will not
proceed.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationShouldTerminateAfterLastWindowClosed$">applicationShouldTerminateAfterLastWindowClosed: </a></h3>
- (BOOL) <b>applicationShouldTerminateAfterLastWindowClosed:</b> (id)sender;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked when the last window is closed in an
application. If <code>YES</code> is returned,
<a rel="gsdoc" href="#method$NSObject(NSApplicationDelegate)-applicationShouldTerminate$">
-applicationShouldTerminate:
</a>
is invoked.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationWillBecomeActive$">applicationWillBecomeActive: </a></h3>
- (void) <b>applicationWillBecomeActive:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application will
become active.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationWillFinishLaunching$">applicationWillFinishLaunching: </a></h3>
- (void) <b>applicationWillFinishLaunching:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application will
become active.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationWillHide$">applicationWillHide: </a></h3>
- (void) <b>applicationWillHide:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application will be
hidden.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationWillResignActive$">applicationWillResignActive: </a></h3>
- (void) <b>applicationWillResignActive:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification just before application
resigns active status.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationWillTerminate$">applicationWillTerminate: </a></h3>
- (void) <b>applicationWillTerminate:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification just before application
terminates. (There is no opportunity to avert
it now.)
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationWillUnhide$">applicationWillUnhide: </a></h3>
- (void) <b>applicationWillUnhide:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application will be
unhidden.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSApplicationDelegate)-applicationWillUpdate$">applicationWillUpdate: </a></h3>
- (void) <b>applicationWillUpdate:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)aNotification;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
Invoked on notification that application will now
update its windows. (See
<a rel="gsdoc" href="#method$NSApplication-updateWindows">[NSApplication -updateWindows]</a>
.
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="005000000000">
Software documentation for the
NSObject(NSServicesRequests)
informal protocol
</a></h1>
<h2><a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSObject.html#class$NSObject">NSObject</a>(<a name="category$NSObject(NSServicesRequests)">NSServicesRequests</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSApplication.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Informal protocol declaring methods for sending to
and receiving from remote services providers.
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSServicesRequests)-iconWindow">-iconWindow</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSServicesRequests)-readSelectionFromPasteboard$">-readSelectionFromPasteboard:</a></li>
<li><a rel="gsdoc" href="NSApplication.html#method$NSObject(NSServicesRequests)-writeSelectionToPasteboard$types$">-writeSelectionToPasteboard:types:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSServicesRequests)-iconWindow">iconWindow </a></h3>
- (<a rel="gsdoc" href="NSWindow.html#class$NSWindow">NSWindow</a>*) <b>iconWindow</b>;<br />
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSServicesRequests)-readSelectionFromPasteboard$">readSelectionFromPasteboard: </a></h3>
- (BOOL) <b>readSelectionFromPasteboard:</b> (<a rel="gsdoc" href="NSPasteboard.html#class$NSPasteboard">NSPasteboard</a>*)pboard;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Request to transfer data from given pasteboard to
selection (called when a called remote service
has provided data to this pasteboard).
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSServicesRequests)-writeSelectionToPasteboard$types$">writeSelectionToPasteboard: types: </a></h3>
- (BOOL) <b>writeSelectionToPasteboard:</b> (<a rel="gsdoc" href="NSPasteboard.html#class$NSPasteboard">NSPasteboard</a>*)pboard<b> types:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)types;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Request to write selection data to given pasteboard
(called when a called remote service is to be
invoked).
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="006000000000">
Software documentation for the NSApplicationDelegate
protocol
</a></h1>
<h2><a name="protocol$(NSApplicationDelegate)">NSApplicationDelegate</a></h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSApplication.h</dd>
</dl>
</blockquote>
<blockquote>
<dl>
<dt><b>Conforms to:</b></dt>
<dd><a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSObject.html#protocol$(NSObject)">NSObject</a></dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> Not in OpenStep/MacOS-X</div>
<br />
<div class="desc">
This is now a formal optional protocol. Your delegate
does not need to implement the full formal protocol.
Your delegate should just implement the methods it needs
to, which will allow <code>NSApp</code> to use default
implementations in other cases.
</div>
<br />
<a href="Gui.html">Up</a>
</font>
</body>
</html>
Server : Apache/2.4.41 (Ubuntu)