Return to NXBrowser.rtf CVS log

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

Annotation of Examples/AppKit/BusyBox/English.lproj/HelpFiles/NXBrowser.rtf, revision 1.1.1.1

1.1       root        1: {\rtf0\ansi{\fonttbl\f1\fswiss Helvetica;\f0\fmodern Courier;}
                      2: \paperw11780
                      3: \paperh9540
                      4: \margl120
                      5: \margr120
                      6: {\colortbl\red0\green0\blue0;}
                      7: \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\f1\b0\i0\ul0\fs36 NXBrowser
                      8: \fs28  
                      9: \fs24 \
                     10: 
                     11: \fc0 \
                     12: 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:\
                     13: \
                     14: 
                     15: \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.\
                     16: \
                     17: �      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.\
                     18: \
                     19: �      If screen space is limited, a pop-up list might be the better choice.  Scrolling lists take up more room.\
                     20: \
                     21: �      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.\
                     22: \
                     23: �      If the user can select more than one item from the list, a pop-up list is inappropriate.\
                     24: 
                     25: \pard\tx1140\tx2300\tx3440\tx4600\tx5760\tx6900\tx8060\tx9200\tx10360\tx11520\fc0 \
                     26: 
                     27: \b Double-Clicking an Item in a List\
                     28: 
                     29: \b0 \
                     30: 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).\
                     31: 
                     32: }

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