home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / NeXTanswers / OpenStepSpec_rtf / ApplicationKit / Classes / NSPopUpButton.rtf < prev    next >
Encoding:
Text File  |  1994-07-01  |  7.3 KB  |  106 lines
  1. {\rtf0\ansi\paperw16228 \paperh18648 \margl-907 \margr0 \margt0 \margb0 {\fonttbl\f0\fswiss Helvetica;\f1\froman Times;\f2\fmodern Courier;\f3\ftech Symbol;\f4\froman Palatino;}
  2. {\stylesheet{\s0 \li100 \fi0 \ri1007 \ql   1Head;}
  3. {\s1 \li100 \fi0 \ri1007 \ql   ClassName;}
  4. {\s2 \li2872 \fi-2771 \ri1007 \ql \tx2872   ConformsTo;}
  5. {\s3 \li2872 \fi-2771 \ri1007 \ql   DeclaredIn;}
  6. {\s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030   Description;}
  7. {\s5 \li7030 \fi-5796 \ri1007 \ql   DescriptionPart;}
  8. {\s6 \li0 \fi0 \ri0 \ql \tx-25 \tx8290 \tx9172   Footer;}
  9. {\s7 \li2872 \fi-2771 \ri1007 \ql \tx2872   InheritsFrom;}
  10. {\s8 \li100 \fi0 \ri1007 \ql   Summary;}
  11. }
  12. \li0 \fi0 \ri0 \ql \sb0 \f1 \fs24 
  13. (Preliminary Documentation) Copyright \f3 \'e3\f1 1994 by NeXT Computer, Inc.  All Rights Reserved.\
  14. \
  15. \s0 \li100 \fi0 \ri1007 \ql \f0 \b \fs36 \fs16 \
  16. \
  17. \
  18. \
  19. \
  20. \
  21. \
  22. \fs36 NSPopUpButton \
  23. \pard \s7 \li2872 \fi-2771 \ri1007 \ql \tx2872 \f1 \b0 \fs28 \fs16 \
  24. \
  25. \
  26. \fs28 \f0 \b \fs28 Inherits From:    \b0 \fs28 \f1 NSButton\
  27. \fs16 \
  28. \fs28 \s2 \fs16 \fs28 \f0 \b \fs28 Conforms To:    \b0 \fs28 \f1 NSCoding\
  29. \fi0 NSObject \
  30. \fs16 \
  31. \fs28 \s3 \fi-2771 \fs16 \fs28 \f0 \b \fs28 Declared In:    \b0 \fs28 \f1 appkit/NSPopUpButton.h \
  32. \fs16 \
  33. \fs28 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs28 \fs16 \
  34. \
  35. \fs28 Initializing a NSPopUpButton \
  36. \fs16 \
  37. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (id)\b initWithFrame:\b0 (NSRect)\i frameRect\i0     Initializes a newly allocated NSPopUpButton, giving it the \
  38. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \b pullsDown:\b0 (BOOL)\i flag        \i0 frame specified by \i frameRect.\i0   If \i flag\i0  is YES, the receiver is initialized to operate as a pull-down list; otherwise, it operates as a pop-up list.\
  39. \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  40. \
  41. \
  42. \fs28 Adding Items \
  43. \fs16 \
  44. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (void)\b addItemWithTitle:\b0 (NSString *)\i title\i0     Adds an item with \i title\i0  as its title to the end of the item list.\
  45. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b addItemsWithTitles:\b0 (NSArray *)\i itemTitles\i0     Adds multiple items to the end of the item list.  The titles for the new items are taken take from the \i itemTitles \i0 array\i .\
  46. \fi-6552 \fi-6552 \i0 \fi-6552 {\f3 -} (void)\b insertItemWithTitle:\b0 (NSString *)\i title\i0     Inserts an item with \i title\i0  as its title at position \i index\i0 . \
  47. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \b atIndex:\b0 (unsigned int)\i index\
  48. \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \i0 \fs16 \
  49. \
  50. \
  51. \fs28 Removing Items \
  52. \fs16 \
  53. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (void)\b removeAllItems\b0     Removes all items in the receiver\'27s item list. \
  54. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b removeItemWithTitle:\b0 (NSString *)\i title\i0     Removes the item whose title matches \i title.\i0  \
  55. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b removeItemAtIndex:\b0 (int)\i index\i0     Removes the item at the specified index.\
  56. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  57. \
  58. \
  59. \fs28 Querying the NSPopUpButton About Its Items \
  60. \fs16 \
  61. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (int)\b indexOfItemWithTitle:\b0 (NSString *)\i title\i0     Returns the index of the item whose title matches \i title\i0 , or NSNotFound if no match is found.\
  62. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (int)\b indexOfSelectedItem\b0     Returns the index of the item last selected by the user, or NSNotFound if there\'27s no selected item.\
  63. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (int)\b numberOfItems\b0     Returns the number of items in the receiver\'27s item list. \
  64. \fi-6552 \fi-6552 \fi-6552 \
  65. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSMenuCell *)\b itemAtIndex:\b0 (int)\i index\i0     Returns the NSMenuCell for the item at \i index\i0 , or \b nil\b0  if no such item exists.\
  66. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSMatrix *)\b itemMatrix\b0     Returns the NSMatrix that holds the receiver\'27s items.\
  67. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSString *)\b itemTitleAtIndex:\b0 (int)\i index\i0     Returns the title of the item at \i index\i0 , or the empty string if no such item exists.\
  68. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSArray *)\b itemTitles\b0     Returns an NSArray that holds the titles of the receiver\'27s items.\
  69. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSMenuCell *)\b itemWithTitle:\b0 (NSString *)\i title\i0     Returns the NSMenuCell for the item whose title is \i title\i0 , or \b nil\b0  if no such item exists\
  70. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSMenuCell *)\b selectedItem\b0     Returns the NSMenuCell for the selected item.\
  71. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSString *)\b titleOfSelectedItem\b0     Returns the title of the item last selected by the user, or the empty string if there\'27s no such item.\
  72. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  73. \
  74. \
  75. \fs28 Manipulating the NSPopUpButton\
  76. \fs16 \
  77. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSFont *)\b font\b0     Returns the font used to draw the items. \
  78. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (BOOL)\b pullsDown\b0     Returns YES if the receiver is configured as a pull-down list, and NO if it\'27s configured as a pop-up list.\
  79. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b selectItemAtIndex:\b0 (int)\i index\i0     Selects the item at \i index\i0  and invokes \b synchronizeTitleAndSelectedItem\b0 .\
  80. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b selectItemWithTitle:\b0 (NSString *)\i title\i0     Selects the item whose title is \i title\i0  and invokes \b synchronizeTitleAndSelectedItem\b0 .\
  81. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setFont:\b0 (NSFont *)\i fontObject\i0     Sets the font used to draw the items.\
  82. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setPullsDown:\b0 (BOOL)\i flag\i0     If \i flag\i0  is YES, the receiver is configured as a pull-down list.  If \i flag\i0  is NO, the receiver is configured as a pop-up list.\
  83. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setTitle:\b0 (NSString *)\i aString\i0     Adds a new item (if the receiver doesn\'27t already have an item titled \i aString\i0 ) and invokes \b synchronizeTitleAndSelectedItem\b0 . \
  84. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSString *)\b stringValue\b0     Returns the title of the selected item.\
  85. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b synchronizeTitleAndSelectedItem\b0     Ensures that the receiver\'27s title agrees with the title of the selected item (see \b indexOfSelectedItem\b0 ).  If there\'27s no selected item, this method selects the first item in the item list and sets the receiver\'27s title to match.  This method is useful in subclasses that directly select items in the item matrix or that override \b setTitle:\b0 .\
  86. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  87. \
  88. \
  89. \fs28 Displaying the NSPopUpButton\'27s Items \
  90. \fs16 \
  91. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (BOOL)\b autoenablesItems\b0     Returns whether the NSPopUpButton enables and disables its items.  (See the NSMenuActionResponder informal protocol.)\
  92. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setAutoenablesItems:\b0 (BOOL)\i flag\i0     Sets whether the NSPopUpButton enables and disables its items.  (See the NSMenuActionResponder informal protocol.)\
  93. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \
  94. \pard \s0 \li100 \fi0 \ri1007 \tx478 \tx856 \tx1234 \fs28 \fs16 \
  95. \
  96. \fs28 \
  97. \fs16 \
  98. \
  99. \fs28 \fs16 \fs28 \
  100. \fs16 \
  101. \
  102. \fs28 \fs16 \fs28 \
  103. \fs16 \
  104. \
  105. \fs28 }
  106.