home *** CD-ROM | disk | FTP | other *** search
/ Altsys Virtuoso 2.0K / virtuoso_20k.iso / NeXTanswers / OpenStepSpec_rtf / ApplicationKit / Classes / NSSavePanel.rtf < prev    next >
Encoding:
Text File  |  1994-07-01  |  6.4 KB  |  116 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 NSSavePanel \
  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 NSPanel : NSWindow : NSResponder : NSObject \
  27. \fs16 \
  28. \fs28 \s3 \fs16 \fs28 \f0 \b \fs28 Declared In:    \b0 \fs28 \f1 appkit/NSNSSavePanel.h \
  29. \fs16 \
  30. \fs28 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs28 \fs16 \
  31. \
  32. \fs28 Allocating, Creating and Freeing a NSSavePanel \
  33. \fs16 \
  34. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 +(NSSavePanel *)\b savePanel    \b0 Creates and returns a recyclable NSSavePanel object.\
  35. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  36. \
  37. \
  38. \fs28 Customizing the NSSavePanel \
  39. \fs16 \
  40. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (void)\b setAccessoryView:\b0 (NSView *)\i aView\i0     Adds an application-customized view to the save panel. \
  41. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSView *)\b accessoryView\b0     Returns the application-customized view object. \
  42. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setTitle:\b0 (NSString *)\i title\i0     Sets the title of the NSSavePanel to \i title\i0 . \
  43. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSString *)\b title\b0     Returns the title of the NSSavePanel.\
  44. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setPrompt:\b0 (NSString *)\i prompt\i0     Sets the title of the form field for the path to \i prompt\i0 .\
  45. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSString *)\b prompt\b0     Returns the title of the form field for the path.\
  46. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  47. \
  48. \
  49. \fs28 Setting Directory and File Type \
  50. \fs16 \
  51. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSString *)\b requiredFileType\b0     Gets the required file type (if any). \
  52. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setDirectory:\b0 (NSString *)\i path\i0     Sets the current directory of the NSSavePanel.\
  53. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setRequiredFileType:\b0 (NSString *)\i type\i0     Sets the required file type (if any). \
  54. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b setTreatsFilePackagesAsDirectories:\b0 (BOOL)\i flag\
  55. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \i0     Sets whether the NSSavePanel object treats file packages as directories by showing their contents in the browser.\
  56. \s4 \li7029 \fi-5794 \fi-6552 \fi-6552 {\f3 -} (BOOL)t\b reatsFilePackagesAsDirectories    \b0 Returns YES if the NSSavePanel treats file packages as directories, thereby allowing users to browse the contents of file packages.\
  57. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  58. \
  59. \
  60. \fs28 Running the NSSavePanel \
  61. \fs16 \
  62. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (int)\b runModalForDirectory:\b0 (NSString *)\i path\i0     Displays the NSSavePanel and begins its event loop,\
  63. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \b file:\b0 (NSString *)\i filename\i0      showing \i path\i0  in the browser and selecting \i filename\i0 . \
  64. \s4 \li7029 \fi-5794 \fi-6552 \fi-6552 {\f3 -} (int)\b runModal\b0     Displays the NSSavePanel and begins its event loop. \
  65. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  66. \
  67. \
  68. \fs28 Reading Save Information \
  69. \fs16 \
  70. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSString *)\b directory\b0     Returns the directory that the chosen file resides in. \
  71. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (NSString *)\b filename\b0     Returns the full name of the file to be saved.\
  72. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  73. \
  74. \
  75. \fs28 Target and Action Methods \
  76. \fs16 \
  77. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (void)\b ok:\b0 (id)\i sender\i0     Method invoked by the OK button. \
  78. \fi-6552 \fi-6552 \fi-6552 {\f3 -} (void)\b cancel:\b0 (id)\i sender\i0     Method invoked by the Cancel button.\
  79. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  80. \
  81. \
  82. \fs28 Responding to User Input \
  83. \fs16 \
  84. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (void)\b selectText:\b0 (id)\i sender\i0     Invoked when users press Tab, Shift-Tab, or an arrow key.\
  85. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  86. \
  87. \
  88. \fs28 Setting the Delegate \
  89. \fs16 \
  90. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (void)\b setDelegate:\b0 (id)\i anObject\i0     Makes \i anObject\i0  the NSSavePanel\'27s delegate. \
  91. \fi-6552 \pard \s8 \li100 \fi0 \ri1007 \ql \f0 \b \fs16 \
  92. \
  93. \
  94. \fs28 Methods implemented by the Delegate \
  95. \fs16 \
  96. \fs28 \pard \s4 \li7029 \fi-6552 \ri1007 \ql \tx6652 \tx7030 \f1 \b0 \fi-6552 {\f3 -} (NSComparisonResult)\b panel:\b0 (id)\i sender\i0     Returns NSOrderedDescending if \i filename1\i0  precedes\
  97. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \b compareFilename:\b0 (NSString *)\i filename1\i0       \i     filename2\i0 , NSOrderAscending in the opposite case,\
  98. \b with:\b0 (NSString *)\i filename2\i0          NSOrderedSame if the two are equivalent.\
  99. \b caseSensitive:\b0 (BOOL)\i caseSensitive\i0      \
  100. \s4 \li7029 \fi-5794 \fi-6552 \fi-6552 {\f3 -} (BOOL)\b panel:\b0 (id)\i sender\i0     Returns YES if \i filename\i0  should be displayed in the\
  101. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \b shouldShowFilename:\b0 (NSString *)\i filename\i0          browser. \
  102. \s4 \li7029 \fi-5794 \fi-6552 \fi-6552 {\f3 -} (BOOL)\b panel:\b0 (id)\i sender\i0     Returns YES if  \i filename\i0  is acceptable to the delegate. \
  103. \fi-6552 \s5 \li7030 \fi-6553 \fi-5796 \b isValidFilename:\b0 (NSString*)\i filename\
  104. \pard \s0 \li100 \fi0 \tx478 \tx856 \tx1234 \i0 \fs28 \fs16 \
  105. \
  106. \fs28 \
  107. \fs16 \
  108. \
  109. \fs28 \ri1007 \fs16 \fs28 \
  110. \fs16 \
  111. \
  112. \fs28 \fs16 \fs28 \
  113. \fs16 \
  114. \
  115. \fs28 }
  116.