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     ! 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.