home *** CD-ROM | disk | FTP | other *** search
/ MacFormat 1996 July / macformat-039.iso / Shareware City / Comms / Internet Shareware / batch-ftp-20-as / Batch FTP 2.00.sit / Batch FTP 2.00 / Choose Item docs / Documentation (.txt) next >
Encoding:
4D Write document  |  1994-05-09  |  10.7 KB  |  141 lines  |  [4WRT/Twri]
  1. 4WRTDOCU
  2. .PARAPARA
  3. HPARAPARA
  4. Choose Item
  5. .PARAPARA
  6. >PARAPARA
  7. .PARAPARA
  8. <PARAPARA
  9. ]B|TEXT
  10. PARAPARA
  11. ]BxTEXT
  12. The Choose Item scripting addition allows you to choose an AppleScript list item from a dialog box like the one illustrated below.STYL
  13. <PARAPARA
  14. ]BtTEXT
  15. .PARAPARA
  16. hPARAPARA
  17. ]BpTEXT
  18. "Figure 1.    A Choose Item dialog boxSTYL
  19.     FORM
  20. .PARAPARA
  21. <PARAPARA
  22. ]BlTEXT
  23. PARAPARA
  24. ]@xPICT
  25. ?373d
  26. <PARAPARA
  27. PARAPARA
  28. jA scripting addition is a command that is added to the AppleScript language as an extension. To install Choose Item, copy the "Choose Item" file into the Scripting Additions folder, which is located in the Extensions folder in your System folder. For more information about Scripting Additions, refer to the "AppleScript Language Guide" from Apple Computer, Inc.STYL
  29. <PARAPARA
  30. LPARAPARA
  31. SYNTAXSTYL
  32. <PARAPARA
  33. PARAPARA
  34. 7 choose item choiceList  [ with prompt promptString ] 
  35. 4FORM
  36. PARAPARA
  37. 9     [ in order sortOrder ]  [ default item defaultString  ]
  38. 6FORM
  39. <PARAPARA
  40. PPARAPARA
  41. PARAMETERSSTYL
  42. <PARAPARA
  43. \PARAPARA
  44.     choiceList
  45. .PARAPARA
  46. tPARAPARA
  47. -The list of items to be proposed to the user.
  48. RPARAPARA
  49. Class: List of stringsSTYL
  50. .PARAPARA
  51. <PARAPARA
  52. ^PARAPARA
  53.     promptString
  54. .PARAPARA
  55. PARAPARA
  56. The title that is displayed in the dialog box. If you omit the with
  57. prompt parameter, the string "Choose an item:" is displayed.STYL
  58. JFORM
  59. .PARAPARA
  60. JPARAPARA
  61. Class: String
  62. \PARAPARA
  63.  Default Value: "Choose an item:"STYL
  64. .PARAPARA
  65. <PARAPARA
  66. ZPARAPARA
  67.     sortOrderSTYL
  68. .PARAPARA
  69. PARAPARA
  70. The sorting order that is used to sort the items in the dialog box. If you omit the in
  71. order parameter, the items are not sorted.
  72. \FORM
  73. PARAPARA
  74. @Class: Enumerated. Possible values are Ascending and Descending.STYL
  75. ?FORM
  76. VPARAPARA
  77. Default Value: no sorting
  78. .PARAPARA
  79. <PARAPARA
  80. ]BXTEXT
  81. ^PARAPARA
  82. ]BTTEXT
  83.     defaultStringSTYL
  84. .PARAPARA
  85. PARAPARA
  86. ]BPTEXT
  87. CThe item string that is first selected when the dialog box appears.
  88. PARAPARA
  89. ]BDTEXT
  90. BIf defaultString is not in choiceList, it is appended to the list.STYL
  91. %FORM
  92. JPARAPARA
  93. ]B@TEXT
  94. Class: String.STYL
  95. \PARAPARA
  96. ]B<TEXT
  97. Default Value: no item selected
  98. .PARAPARA
  99. $PARAPARA
  100. BPARAPARA
  101. ]B8TEXT
  102. RESULTSTYL
  103. <PARAPARA
  104. vPARAPARA
  105. 9    The result is the text of the item selected by the user.
  106. <PARAPARA
  107. DPARAPARA
  108. EXAMPLESSTYL
  109. <PARAPARA
  110. PARAPARA
  111. T    choose item {"Black","Yellow","Green","Blue","Red"} with prompt "Choose a color:" 
  112. fPARAPARA
  113. )        in order Ascending default item "Black"
  114. \PARAPARA
  115.      set color of myObject to resultSTYL
  116. <PARAPARA
  117. BPARAPARA
  118. ERRORSSTYL
  119. <PARAPARA
  120. nPARAPARA
  121. ]B\TEXT
  122. 2    -1700    "Can't change <expression> into a <class>."STYL
  123. PARAPARA
  124. A        One of the choiceList items could not be displayed as a string.
  125. pPARAPARA
  126. 3    -108    "Not enough memory to perform the operation."
  127. jPARAPARA
  128. -        Not enough memory to perform the operation.
  129. dPARAPARA
  130. '    - 128    "User cancelled the dialog box."
  131. \PARAPARA
  132. ]BhTEXT
  133.          The Cancel button was pressed.STYL
  134. <PARAPARA
  135. *FNTSFNTS
  136. Palatino
  137. Geneva
  138. hSTLSSTLS
  139. AppleScript
  140. AppleScript Paramc
  141.