Return to NXBrowser.rtf CVS log

Up to [NeXTSTEP 3.3 examples] / Examples / AppKit / BusyBox / English.lproj / HelpFiles

Sample Programs from NeXSTEP 3.3

{\rtf0\ansi{\fonttbl\f1\fswiss Helvetica;\f0\fmodern Courier;}
\paperw11780
\paperh9540
\margl120
\margr120
{\colortbl\red0\green0\blue0;}
\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f1\b0\i0\ul0\fs36 NXBrowser
\fs28  
\fs24 \

\fc0 \
The NXBrowser class is used to provide the user with a scrolling list of choices.  Pop-up lists and radio buttons can also be used to display a group of options, however, scrolling lists distinguish themselves because they can offer multiple selection.  Unlike radio buttons, scrolling lists and pop-up lists both can have their contents altered dynamically, and both save screen space.  The following considerations enter into the decision whether to implement a control as a pop-up list or as a scrolling list:\
\

\pard\tx180\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\fi-180\li180\fc0 �	If it's conceivable that the list could grow to be very large, a scrolling list is the better choice.  The entire contents of a pop-up list must fit on-screen.  Unbounded lists should never be implemented as pop-up lists.  A good example of this is the scrolling list of font families in the Font Panel.  There is no bound on the number of fonts the user could have installed, therefore, a scrolling list is the proper choice.\
\
�	On the other hand, if the list is short or limited, a pop-up list might be the better choice.  Pop-up lists let the user see all the available options on-screen at once.\
\
�	If screen space is limited, a pop-up list might be the better choice.  Scrolling lists take up more room.\
\
�	If the user needs to see at least some of the choices on-screen to understand what's in the list, a scrolling list might be the better choice.  More of the list is always visible.\
\
�	If the user can select more than one item from the list, a pop-up list is inappropriate.\

\pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\fc0 \

\b Double-Clicking an Item in a List\

\b0 \
Often a panel provides the user with a list of choices (e.g., the Open and Save panels).  Double-clicking an item within the list should perform the same action as pressing the Return key (i.e., the same action as the button marked with the Return symbol).\

}

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.