RexxReqTools list of Tags This is an alphabetical list of all tags per type (number, constant or string) that RexxReqTools understands: number tags: rt_leftoffset rt_screen rt_topoffset rtez_defaultresponse rtfi_height rtfo_fontheight rtfo_height rtfo_maxheight rtfo_minheight rtfo_sampleheight rtgl_max rtgl_min rtgl_width rtgs_width rtsc_height rtsc_maxdepth rtsc_maxheight rtsc_maxwidth rtsc_mindepth rtsc_minheight rtsc_minwidth constant tags: rt_idcmpflags rt_lockwindow rt_reqpos rt_screentofront rt_waitpointer rt_window rtez_flags rtfi_buffer rtfi_flags rtfi_volumerequest rtfo_flags rtgl_backfill rtgl_flags rtgl_invisible rtgs_backfill rtgs_flags rtgs_invisible rtsc_flags string tags: rt_font rt_pubscrname rtfi_initialpath rtfi_matchpat rtfo_fontname ---------------------------------------------------------------------------- RexxReqTools Tag: rt_font NAME rt_font VALUE string DESCRIPTION Name of the font that you want RexxReqTools to use for the requester. Font name and height should be separated by a slash (`/'), font name should include `.font'. Note that this font should be fixed width for the file requester, font requester, color requester and the screen mode requester. EXAMPLE `rt_font=diamond.font/20' FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_pubscrname NAME rt_pubscrname VALUE string DESCRIPTION Name of public screen requester should appear on. When this tag is used the rt_window tag will be ignored. If the public screen is not found the requester will open on the default public screen. RexxReqTools will always try to open the requester on the same screen as the calling program (TECH INFO: but this may not always be possible because some programs don't set their pr_WindowPtr). EXAMPLE 'rt_pubscrname=PowerPacker' FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfi_initialpath NAME rtfi_initialpath VALUE string DESCRIPTION This is the path of the file requester, the first time it is used. Don't use the directory argument if you use this tag. The second time the file requester is used, it will use the same path as the path that was in use when the file requester was OK'd or cancelled the first time. If you use the directory argument the path will always be this path, even if you changed it the last time you used the file requester. EXAMPLE 'rtfi_initialpath=REXX:' FUNCTIONS rtfilerequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfi_matchpat NAME rtfi_matchpat VALUE string DESCRIPTION Pattern string to match files on. EXAMPLE 'rtfi_matchpat=#?.doc' FUNCTIONS rtfilerequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfo_fontname NAME rtfo_fontname VALUE string DESCRIPTION Set the name of the selected font. FUNCTIONS rtfontrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_idcmpflags NAME rt_idcmpflags VALUE One or more of the following: idcmp_diskinserted idcmp_diskremoved idcmp_mousebuttons idcmp_inactivewindow idcmp_rawkey idcmp_vanillakey DESCRIPTION Allows you to specify other conditions on which the requester will return. FUNCTIONS rtezrequest() rtgetlong() rtgetstring() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_lockwindow NAME rt_lockwindow VALUE true or false DESCRIPTION If this is true the window calling the requester will get locked. It will no longer accept any user input and it will get standard wait pointer set. DEFAULT false FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_reqpos NAME rt_reqpos VALUE One of the following: reqpos_centerscr reqpos_centerwin reqpos_pointer reqpos_topleftscr reqpos_topleftwin DESCRIPTION This tag describes the requesters position. The requester will always remain in the visible part of the screen, so if you use the Screen Mode preferences editor to enlarge your Workbench screen and you scroll around, the requester will always appear in the part you can see. reqpos_centerscr and reqpos_topleftscr also apply to the visible part of the screen. So if you use one of these the requester will be appear in the center or the top left of what you can see of the screen as opposed to the entire screen. reqpos_centerwin and reqpos_topleftwin fall back to reqpos_centerscr or reqpos_topleftscr respectively when there is no parent window. So you can safely use these without worrying about the existence of a window. DEFAULT reqpos_pointer FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_screentofront NAME rt_screentofront VALUE true or false DESCRIPTION Boolean indicating whether to pop the screen the requester will appear on to the front. DEFAULT true FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_waitpointer NAME rt_waitpointer VALUE true or false DESCRIPTION If this is true the window calling the requester will get a standard wait pointer set while the requester is up. DEFAULT false FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtez_flags NAME rtez_flags VALUE One or more of the following: ezreqf_centertext ezreqf_lamigaqual ezreqf_noreturnkey DESCRIPTION Flags for rtezrequest() FUNCTIONS rtezrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfi_buffer NAME rtfi_buffer VALUE true or false DESCRIPTION Use a buffer to remember directory contents for the next time rtfilerequest() is used. This tag acts like a switch: after you have used "rtfi_buffer=true" buffering will be turned on until it is turned off again. DEFAULT false FUNCTIONS rtfilerequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfi_flags NAME rtfi_flags VALUE One or more of the following: freqf_multiselect freqf_nofiles freqf_patgad freqf_save freqf_selectdirs DESCRIPTION Flags for rtfilerequest(). FUNCTIONS rtfilerequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfi_volumerequest NAME rtfi_volumerequest VALUE One or more of the following: vreqf_alldisks vreqf_noassigns vreqf_nodisks DESCRIPTION The presence of this tag turns the file requester into a volume/assign disk requester. This requester can be used to get a device name ("DF0:", "DH1:",..) or an assign ("C:", "FONTS:",...) from the user. Note that the user may edit the disk/assign names, or enter a new one. Note also that the real device name is returned, not the name of the volume in the device. For example "DH1:", not "Hard1:". NOTE: Do *NOT* use "rtfi_volumerequest 1"! You are then setting the vreqf_noassigns flag! Use "rtfi_volumerequest 0" for a normal volume requester. FUNCTIONS rtfilerequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfo_flags NAME rtfo_flags VALUE One or more of the following: freqf_changepalette freqf_colorfonts freqf_fixedwidth freqf_leavepalette freqf_scale freqf_style DESCRIPTION Flags for rtfontrequest() FUNCTIONS rtfontrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgl_backfill NAME rtgl_backfill VALUE true or false DESCRIPTION Backfill requester window with pattern. DEFAULT true FUNCTIONS rtgetlong() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgl_flags NAME rtgl_flags VALUE One or more of the following: glreqf_centertext glreqf_highlighttext DESCRIPTION Flags for rtgetlong(). FUNCTIONS rtgetlong() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgl_invisible NAME rtgl_invisible@ VALUE true or false DESCRIPTION Using this tag you can switch on invisible typing. Very useful if you need to get something like a code number from the user. DEFAULT false FUNCTIONS rtgetlong() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgs_backfill NAME rtgs_backfill VALUE true or false DESCRIPTION Backfill requester window with pattern. DEFAULT true FUNCTIONS rtgetstring() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgs_flags NAME rtgs_flags VALUE One or more of the following: gsreqf_centertext gsreqf_highlighttext DESCRIPTION Flags for rtgetstring() FUNCTIONS rtgetstring() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgs_invisible NAME rtgs_invisible VALUE true or false DESCRIPTION Using this tag you can switch on invisible typing. Very useful if you need to get something like a password from the user. It is strongly advised to use an empty initial string or the user may get very confused! DEFAULT false FUNCTIONS rtgetstring() ---------------------------------------------------------------------------- RexxReqTools Tag: rtsc_flags NAME rtsc_flags VALUE One or more of the following: screqf_overscangad screqf_autoscrollgad screqf_sizegads screqf_depthgad screqf_nonstdmodes screqf_guimodes DESCRIPTION Flags for the screen mode requester. FUNCTIONS rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_leftoffset NAME rt_leftoffset VALUE number DESCRIPTION Offset of left edge of requester relative to position specified with rt_reqpos (does not offset the requester when rt_reqpos is reqpos_pointer). FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_screen NAME rt_screen VALUE number DESCRIPTION Address of screen to put requester on. You should never use this, use rt_window or rt_pubscrname. RexxReqTools contains attributes to set the screen on which the requester will appear (rt_window, rt_screen, rt_pubscrname). But I would like to discourage you from using rt_window and rt_screen, because incorrect use will crash the computer. RexxReqTools will always try to open the requester on the same screen as the calling program (TECH INFO: but this may not always be possible because some programs don't set their pr_WindowPtr). FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_topoffset NAME rt_topoffset VALUE number DESCRIPTION Offset of top edge of requester relative to position specified with rt_reqpos (does not offset the requester when rt_reqpos is reqpos_pointer). FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rt_window NAME rt_window VALUE number DESCRIPTION Window that will be used to find the screen to put the requester on. RexxReqTools contains attributes to set the screen on which the requester will appear (rt_window, rt_screen, rt_pubscrname). But I would like to discourage you from using rt_window and rt_screen, because incorrect use will crash the computer. RexxReqTools will always try to open the requester on the same screen as the calling program (TECH INFO: but this may not always be possible because some programs don't set their pr_WindowPtr). FUNCTIONS rtezrequest() rtfilerequest() rtfontrequest() rtgetlong() rtgetstring() rtpaletterequest() rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtez_defaultresponse NAME rtez_defaultresponse VALUE number DESCRIPTION Response value that will be returned when the user presses the return key. Will be ignored if the ezreqf_noreturnkey flag is set. The text for this response will be printed in bold. DEFAULT 1 (ie. the leftmost gadget) FUNCTIONS rtezrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfi_height NAME rtfi_height VALUE number DESCRIPTION Suggested height of file requester window. FUNCTIONS rtfilerequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfo_fontheight NAME rtfo_fontheight VALUE number DESCRIPTION Set the fontsize of the selected font. FUNCTIONS rtfontrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfo_height NAME rtfo_height VALUE number DESCRIPTION Suggested height of font requester window. FUNCTIONS rtfontrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfo_maxheight NAME rtfo_maxheight VALUE number DESCRIPTION Maximum font size displayed. FUNCTIONS rtfontrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfo_minheight NAME rtfo_minheight VALUE number DESCRIPTION Minimum font size displayed. FUNCTIONS rtfontrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtfo_sampleheight NAME rtfo_sampleheight VALUE number DESCRIPTION Height of font sample display in pixels. DEFAULT 24 FUNCTIONS rtfontrequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgl_max NAME rtgl_max VALUE number DESCRIPTION Maximum allowed value, higher values are refused. FUNCTIONS rtgetlong() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgl_min NAME rtgl_min VALUE number DESCRIPTION Minimum allowed value. If the user tries to enter a smaller value the requester will refuse to accept it. FUNCTIONS rtgetlong() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgl_width NAME rtgl_width VALUE number DESCRIPTION Width of requester window in pixels. This is only a suggestion. rtgetlong() will not go below a certain width. FUNCTIONS rtgetlong() ---------------------------------------------------------------------------- RexxReqTools Tag: rtgs_width NAME rtgs_width VALUE number DESCRIPTION Width of requester window in pixels. This is only a suggestion. rtgetstring() will not go below a certain width. FUNCTIONS rtgetstring() ---------------------------------------------------------------------------- RexxReqTools Tag: rtsc_height NAME rtsc_height VALUE number DESCRIPTION Suggested height of the screen mode requester window. FUNCTIONS rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtsc_maxdepth NAME rtsc_maxdepth VALUE number DESCRIPTION The maximum display depth allowed. FUNCTIONS rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtsc_maxheight NAME rtsc_maxheight VALUE number DESCRIPTION The maximum display height allowed. FUNCTIONS rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtsc_maxwidth NAME rtsc_maxwidth VALUE number DESCRIPTION The maximum display width allowed FUNCTIONS rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtsc_mindepth NAME rtsc_mindepth VALUE number DESCRIPTION The minimum display depth allowed. Modes with a minimum display depth lower than this value will not be included in the list. FUNCTIONS rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtsc_minheight NAME rtsc_minheight VALUE number DESCRIPTION The minimum display height allowed. FUNCTIONS rtscreenmoderequest() ---------------------------------------------------------------------------- RexxReqTools Tag: rtsc_minwidth NAME rtsc_minwidth VALUE number DESCRIPTION The minimum display width allowed. FUNCTIONS rtscreenmoderequest() ----------------------------------------------------------------------------