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 : /proc/self/root/usr/share/GNUstep/Documentation/Developer/Gui/Reference/
Upload File :
Current File : //proc/self/root/usr/share/GNUstep/Documentation/Developer/Gui/Reference/NSComboBox.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>NSComboBox</title>
</head>
<body>
<font face="serif">
<a href="Gui.html">Up</a>
<br />
<h1><a name="title$NSComboBox">NSComboBox</a></h1>
<h3>Authors</h3>
<dl>
<dt>Gerrit van Dyk (<a href="mailto:gerritvd@decillion.net"><code>gerritvd@decillion.net</code></a>)</dt>
<dd>
</dd>
</dl>
<p><b>Copyright:</b> (C) 1999 Free Software Foundation, Inc.</p>
<div>
<hr width="50%" align="left" />
<h3>Contents -</h3>
<ol>
<li>
<a href="#001000000000">Class</a>
</li>
<li>
<a href="#002000000000">Software documentation for the
NSObject(NSComboBoxDataSource)
informal protocol</a>
</li>
<li>
<a href="#003000000000">Software documentation for the
NSObject(NSComboBoxNotifications)
informal protocol</a>
</li>
</ol>
<hr width="50%" align="left" />
</div>
<h1><a name="001000000000"><strong>Class</strong> Description</a></h1>
<p>
An NSComboBox is what we can call a completion/choices box,
derived from NSTextField, it allows you to enter text
like in a text field but also to click in the ellipsis
button (indicating the fact other user inputs are
possible) on the right of it to obtain a list of
choices, you can use them as the text field value by
selecting a row in this list. You can also obtain
direct completion when it is enabled via
<code>setCompletes:</code> to get a suggested text field
value updated as you type.
</p>
<p>
Like other NSControl classes, NSComboBox is a wrapper
around a core piece which implements the combo box
behavior, a cell, which is in this case an
NSComboBoxCell.
</p>
<h2><a name="class$NSComboBox">NSComboBox</a> : <a rel="gsdoc" href="NSTextField.html#class$NSTextField">NSTextField</a></h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSComboBox.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<br />
</p>
<p>
No special instructions to use NSComboBox or text to
detail the implementation.
</p>
<p>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-addItemWithObjectValue$">-addItemWithObjectValue:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-addItemsWithObjectValues$">-addItemsWithObjectValues:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-completes">-completes</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-dataSource">-dataSource</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-deselectItemAtIndex$">-deselectItemAtIndex:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-hasVerticalScroller">-hasVerticalScroller</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-indexOfItemWithObjectValue$">-indexOfItemWithObjectValue:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-indexOfSelectedItem">-indexOfSelectedItem</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-insertItemWithObjectValue$atIndex$">-insertItemWithObjectValue:atIndex:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-intercellSpacing">-intercellSpacing</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-isButtonBordered">-isButtonBordered</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-itemHeight">-itemHeight</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-itemObjectValueAtIndex$">-itemObjectValueAtIndex:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-noteNumberOfItemsChanged">-noteNumberOfItemsChanged</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-numberOfItems">-numberOfItems</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-numberOfVisibleItems">-numberOfVisibleItems</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-objectValueOfSelectedItem">-objectValueOfSelectedItem</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-objectValues">-objectValues</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-reloadData">-reloadData</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-removeAllItems">-removeAllItems</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-removeItemAtIndex$">-removeItemAtIndex:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-removeItemWithObjectValue$">-removeItemWithObjectValue:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-scrollItemAtIndexToTop$">-scrollItemAtIndexToTop:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-scrollItemAtIndexToVisible$">-scrollItemAtIndexToVisible:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-selectItemAtIndex$">-selectItemAtIndex:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-selectItemWithObjectValue$">-selectItemWithObjectValue:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-setButtonBordered$">-setButtonBordered:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-setCompletes$">-setCompletes:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-setDataSource$">-setDataSource:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-setHasVerticalScroller$">-setHasVerticalScroller:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-setIntercellSpacing$">-setIntercellSpacing:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-setItemHeight$">-setItemHeight:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-setNumberOfVisibleItems$">-setNumberOfVisibleItems:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-setUsesDataSource$">-setUsesDataSource:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSComboBox-usesDataSource">-usesDataSource</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSComboBox-addItemWithObjectValue$">addItemWithObjectValue: </a></h3>
- (void) <b>addItemWithObjectValue:</b> (id)object;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Adds an item to the combo box cell default items list
which is used when <code>usesDataSource</code>
returns <code>NO</code>. In the case
<code>usesDataSource</code> returns <code>YES</code>
, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-addItemsWithObjectValues$">addItemsWithObjectValues: </a></h3>
- (void) <b>addItemsWithObjectValues:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*)objects;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Adds several items in an array to the combo box cell
default items list which is used when
<code>usesDataSource</code> returns <code>NO</code>.
In the case <code>usesDataSource</code> returns
<code>YES</code>, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-completes">completes </a></h3>
- (BOOL) <b>completes</b>;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Returns <code>YES</code> when the combo box cell
automatic completion is active, returns
<code>NO</code> otherwise. Take a look at the
<code>setCompletes:</code> method documentation to
know how the automatic completion works.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-dataSource">dataSource </a></h3>
- (id) <b>dataSource</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the combo box cell data source object which
is reponsible to provide the data to be displayed. To
know how to implement a data source object, take a
look at the NSComboBoxDataSource informal protocol
description. In the case
<code>usesDataSource</code> returns <code>NO</code>,
this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-deselectItemAtIndex$">deselectItemAtIndex: </a></h3>
- (void) <b>deselectItemAtIndex:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)index;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Deselects the combo box cell list row at
<var>index</var> in the case this row is selected.
Posts an NSComboBoxSelectionDidChangeNotification to
the default notification center, when there is a new
selection.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-hasVerticalScroller">hasVerticalScroller </a></h3>
- (BOOL) <b>hasVerticalScroller</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns <code>YES</code> when the combo box cell
displays a vertical scroller for its list, returns
<code>NO</code> otherwise. Take note that the
scroller will be displayed even when the sum of
the items height in the list is inferior to the minimal
height of the list displayed area.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-indexOfItemWithObjectValue$">indexOfItemWithObjectValue: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>indexOfItemWithObjectValue:</b> (id)object;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the lowest index associated with a value in
the combo box cell default items list, which is equal
to <var>object</var>, and returns NSNotFound when there
is no such value. In the case
<code>usesDataSource</code> returns <code>YES</code>
, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-indexOfSelectedItem">indexOfSelectedItem </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>indexOfSelectedItem</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the index of the selected item in the combo
box cell list or -1 when there is no selection, the
selected item can be related to the data source
object in the case <code>usesDataSource</code>
returns <code>YES</code> else to the default items
list.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-insertItemWithObjectValue$atIndex$">insertItemWithObjectValue: atIndex: </a></h3>
- (void) <b>insertItemWithObjectValue:</b> (id)object<b> atIndex:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)index;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Inserts an item in the combo box cell default items
list which is used when <code>usesDataSource</code>
returns <code>NO</code>. In the case
<code>usesDataSource</code> returns <code>YES</code>
, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-intercellSpacing">intercellSpacing </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/TypesAndConstants.html#type$NSSize">NSSize</a>) <b>intercellSpacing</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the width and the height (as the values of
an NSSize variable) between each item of the combo box
cell list.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-isButtonBordered">isButtonBordered </a></h3>
- (BOOL) <b>isButtonBordered</b>;<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$NSComboBox-itemHeight">itemHeight </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/TypesAndConstants.html#type$CGFloat">CGFloat</a>) <b>itemHeight</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the height of the items in the combo box
cell list.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-itemObjectValueAtIndex$">itemObjectValueAtIndex: </a></h3>
- (id) <b>itemObjectValueAtIndex:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)index;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the object value at <var>index</var> within
combo box cell default items list. When the
<var>index</var> is beyond the end of the list, an
NSRangeException is raised. In the case
<code>usesDataSource</code> returns <code>YES</code>
, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-noteNumberOfItemsChanged">noteNumberOfItemsChanged </a></h3>
- (void) <b>noteNumberOfItemsChanged</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Informs the combo box cell that the number of items
in its data source has changed, in order to permit to
the scrollers in its displayed list being updated
without needing the reload of the data. It is
recommended to use this method with a data
source that continually receives data in the
background, to keep the the combo box cell
responsive to the user while the data is
received. Take a look at the
<code>NSComboBoxDataSource</code> informal protocol
specification to know more on the messages
NSComboBox sends to its data source.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-numberOfItems">numberOfItems </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>numberOfItems</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the number of items in the the combo box
cell list, the numbers of items can be be related to
the data source object in the case
<code>usesDataSource</code> returns <code>YES</code>
else to the default items list.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-numberOfVisibleItems">numberOfVisibleItems </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>numberOfVisibleItems</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the maximum number of allowed items to be
displayed in the combo box cell list.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-objectValueOfSelectedItem">objectValueOfSelectedItem </a></h3>
- (id) <b>objectValueOfSelectedItem</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the object value of the selected item in
the combo box cell default items list or
<code>nil</code> when there is no selection. In the
case <code>usesDataSource</code> returns
<code>YES</code>, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-objectValues">objectValues </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSArray.html#class$NSArray">NSArray</a>*) <b>objectValues</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns the combo box cell default items list in an
array.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-reloadData">reloadData </a></h3>
- (void) <b>reloadData</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Marks the combo box cell in order to have its items
list reloaded in the case it uses a data source, and
to have it redisplayed.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-removeAllItems">removeAllItems </a></h3>
- (void) <b>removeAllItems</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Removes all the items in the combo box cell default
items list which is used when
<code>usesDataSource</code> returns <code>NO</code>.
In the case <code>usesDataSource</code> returns
<code>YES</code>, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-removeItemAtIndex$">removeItemAtIndex: </a></h3>
- (void) <b>removeItemAtIndex:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)index;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Removes the item with the specified
<var>index</var> in the combo box cell default items
list which is used when <code>usesDataSource</code>
returns <code>NO</code>. In the case
<code>usesDataSource</code> returns <code>YES</code>
, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-removeItemWithObjectValue$">removeItemWithObjectValue: </a></h3>
- (void) <b>removeItemWithObjectValue:</b> (id)object;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Removes an item in the combo box cell default items
list which is used when <code>usesDataSource</code>
returns <code>NO</code>. In the case
<code>usesDataSource</code> returns <code>YES</code>
, this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-scrollItemAtIndexToTop$">scrollItemAtIndexToTop: </a></h3>
- (void) <b>scrollItemAtIndexToTop:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)index;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Scrolls the combo box cell list vertically in order
to have the item at <var>index</var> in the closest
position relative to the top. There is no need to
have the list displayed when this method is invoked.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-scrollItemAtIndexToVisible$">scrollItemAtIndexToVisible: </a></h3>
- (void) <b>scrollItemAtIndexToVisible:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)index;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Scrolls the combo box cell list vertically in order
to have the item at <var>index</var> visible. There is
no need to have the list displayed when this method is
invoked.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-selectItemAtIndex$">selectItemAtIndex: </a></h3>
- (void) <b>selectItemAtIndex:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)index;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Selects the combo box cell list row at
<var>index</var>. Take note no changes occurs in the
combo box cell list when this method is called. Posts
an NSComboBoxSelectionDidChangeNotification to the
default notification center when there is a new
selection different from the previous one.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-selectItemWithObjectValue$">selectItemWithObjectValue: </a></h3>
- (void) <b>selectItemWithObjectValue:</b> (id)object;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Selects the first item in the default combo box
cell list which is equal to <var>object</var>. In the
case <code>usesDataSource</code> returns
<code>YES</code>, this method logs a warning. Take
note that this method doesn't update the text field
part value. Posts an NSComboBoxSelectionDidChange
notification to the default notification
center when the new selection is different than the
previous one.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-setButtonBordered$">setButtonBordered: </a></h3>
- (void) <b>setButtonBordered:</b> (BOOL)flag;<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$NSComboBox-setCompletes$">setCompletes: </a></h3>
- (void) <b>setCompletes:</b> (BOOL)completes;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
Sets whether the combo box cell automatic completion
is active or not. The automatic completion tries to
complete what the user types in the text field
part, it tries to complete only when the the user
adds characters at the end of the string, not when it
deletes characters or when the insertion point
precedes the end of the string. To do the
automatic completion, the
<code>completedString:</code> method is called, and
when the returned string is longer than the current
one in the text field, the completion occurs and the
completed part gets selected.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-setDataSource$">setDataSource: </a></h3>
- (void) <b>setDataSource:</b> (id)aSource;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets the combo box cell data source to
<var>aSource</var>. Just calling this method doesn't
set <code>usesDataSource</code> to return
<code>YES</code>, you must call
<code>setUsesDataSource:</code> with
<code>YES</code> before or a warning will be logged.
To know how to implement a data source objects, take a
look at the NSComboBoxDataSource informal protocol
description. When <var>aSource</var> doesn't
respond to the methods
<code>numberOfItemsInComboBox:</code>
<code>comboBox:objectValueForItemAtIndex:</code>,
this method logs a warning.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-setHasVerticalScroller$">setHasVerticalScroller: </a></h3>
- (void) <b>setHasVerticalScroller:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets whether the combo box cell list displays a
vertical scroller, by default it is the case. When
<var>flag</var> is <code>NO</code> and the combo cell
list has more items (either in its default list or
from its data source) than the number returned by
<code>numberOfVisibleItems</code>, only a subset of
them will be displayed. Uses scroll related methods to
position this subset in the combo box cell list.
Take note that the scroller will be displayed even
when the sum of the items height in the list is
inferior to the minimal height of the list
displayed area.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-setIntercellSpacing$">setIntercellSpacing: </a></h3>
- (void) <b>setIntercellSpacing:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/TypesAndConstants.html#type$NSSize">NSSize</a>)aSize;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets the width and the height between each item of the
combo box cell list to the values in <var>aSize</var>
.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-setItemHeight$">setItemHeight: </a></h3>
- (void) <b>setItemHeight:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/TypesAndConstants.html#type$CGFloat">CGFloat</a>)itemHeight;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets the height of the items in the combo box cell
list to <var>itemHeight</var>.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-setNumberOfVisibleItems$">setNumberOfVisibleItems: </a></h3>
- (void) <b>setNumberOfVisibleItems:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)visibleItems;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets the maximum number of allowed items to be
displayed in the combo box cell list.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-setUsesDataSource$">setUsesDataSource: </a></h3>
- (void) <b>setUsesDataSource:</b> (BOOL)flag;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Sets according to <var>flag</var> whether the combo
box cell uses a data source (which is external) to
populate its items list.
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSComboBox-usesDataSource">usesDataSource </a></h3>
- (BOOL) <b>usesDataSource</b>;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
Returns <code>YES</code> when the combo box cell
uses a data source (which is external) to populate its
items list, otherwise returns <code>NO</code> in the
case it uses its default list.
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="002000000000">
Software documentation for the
NSObject(NSComboBoxDataSource)
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(NSComboBoxDataSource)">NSComboBoxDataSource</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSComboBox.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSObject(NSComboBoxDataSource)-comboBox$completedString$">-comboBox:completedString:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSObject(NSComboBoxDataSource)-comboBox$indexOfItemWithStringValue$">-comboBox:indexOfItemWithStringValue:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSObject(NSComboBoxDataSource)-comboBox$objectValueForItemAtIndex$">-comboBox:objectValueForItemAtIndex:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSObject(NSComboBoxDataSource)-numberOfItemsInComboBox$">-numberOfItemsInComboBox:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSComboBoxDataSource)-comboBox$completedString$">comboBox: completedString: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*) <b>comboBox:</b> (<a rel="gsdoc" href="#class$NSComboBox">NSComboBox</a>*)aComboBox<b> completedString:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)aString;<br />
<div class="availability">
<b>Availability:</b> MacOS-X 10.0.0</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSComboBoxDataSource)-comboBox$indexOfItemWithStringValue$">comboBox: indexOfItemWithStringValue: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSUInteger">NSUInteger</a>) <b>comboBox:</b> (<a rel="gsdoc" href="#class$NSComboBox">NSComboBox</a>*)aComboBox<b> indexOfItemWithStringValue:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSString.html#class$NSString">NSString</a>*)string;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSComboBoxDataSource)-comboBox$objectValueForItemAtIndex$">comboBox: objectValueForItemAtIndex: </a></h3>
- (id) <b>comboBox:</b> (<a rel="gsdoc" href="#class$NSComboBox">NSComboBox</a>*)aComboBox<b> objectValueForItemAtIndex:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>)index;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSComboBoxDataSource)-numberOfItemsInComboBox$">numberOfItemsInComboBox: </a></h3>
- (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/BaseAdditions/Reference/TypesAndConstants.html#type$NSInteger">NSInteger</a>) <b>numberOfItemsInComboBox:</b> (<a rel="gsdoc" href="#class$NSComboBox">NSComboBox</a>*)aComboBox;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<h1><a name="003000000000">
Software documentation for the
NSObject(NSComboBoxNotifications)
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(NSComboBoxNotifications)">NSComboBoxNotifications</a>)</h2>
<blockquote class="declared">
<dl>
<dt><b>Declared in:</b></dt>
<dd>AppKit/NSComboBox.h</dd>
</dl>
</blockquote>
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<b>Method summary</b>
<ul>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSObject(NSComboBoxNotifications)-comboBoxSelectionDidChange$">-comboBoxSelectionDidChange:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSObject(NSComboBoxNotifications)-comboBoxSelectionIsChanging$">-comboBoxSelectionIsChanging:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSObject(NSComboBoxNotifications)-comboBoxWillDismiss$">-comboBoxWillDismiss:</a></li>
<li><a rel="gsdoc" href="NSComboBox.html#method$NSObject(NSComboBoxNotifications)-comboBoxWillPopUp$">-comboBoxWillPopUp:</a></li>
</ul>
<hr width="50%" align="left" />
<div class="method">
<h3><a name="method$NSObject(NSComboBoxNotifications)-comboBoxSelectionDidChange$">comboBoxSelectionDidChange: </a></h3>
- (void) <b>comboBoxSelectionDidChange:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)notification;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSComboBoxNotifications)-comboBoxSelectionIsChanging$">comboBoxSelectionIsChanging: </a></h3>
- (void) <b>comboBoxSelectionIsChanging:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)notification;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSComboBoxNotifications)-comboBoxWillDismiss$">comboBoxWillDismiss: </a></h3>
- (void) <b>comboBoxWillDismiss:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)notification;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<div class="method">
<h3><a name="method$NSObject(NSComboBoxNotifications)-comboBoxWillPopUp$">comboBoxWillPopUp: </a></h3>
- (void) <b>comboBoxWillPopUp:</b> (<a rel="gsdoc" href="/usr/share/GNUstep/Documentation/Developer/Base/Reference/NSNotification.html#class$NSNotification">NSNotification</a>*)notification;<br />
<div class="availability">
<b>Availability:</b> OpenStep</div>
<br />
<div class="desc">
<em>Description forthcoming.</em>
</div>
<hr width="25%" align="left" />
</div>
<br />
<a href="Gui.html">Up</a>
</font>
</body>
</html>
Server : Apache/2.4.41 (Ubuntu)