PS (Point-and-Shoot)

The PS tag defines a text string that is to be enabled for point-and-shoot.

Syntax


>>-<PS--VAR=-+-point-and-shoot-variable-name-+------------------>
             '-%varname----------------------'   

>--VALUE=-+-point-and-shoot-value-+--+-----------------+-------->
          +-%varname--------------+  |         .-NO--. |   
          '-*---------------------'  '-CSRGRP=-+-YES-+-'   
                                               '-n---'     

>--+---------------------+--+------------------+---------------->
   '-DEPTH=-+-n--------+-'  '-| IMAP options |-'   
            '-%varname-'                           

>-->--point-and-shoot-text--</PS>------------------------------><

IMAP options

|--IMAPNAME=-+-image-name-+--| IMAP group |---------------------|
             '-%varname---'                   

IMAP group

|--+----------------------------+--+---------------------+------|
   '-IMAPNAMEP=-+-image-namep-+-'  |        .-ABOVE----. |   
                '-%varname----'    '-PLACE=-+-BELOW----+-'   
                                            +-LEFT-----+     
                                            +-RIGHT----+     
                                            '-%varname-'

Parameters

VAR=point-and-shoot-variable-name | %varname

This attribute provides the name of a variable which is to be set when a point-and-shoot phrase is clicked on for selection. You can define this attribute as a variable name preceded by a “%”.

The point-and-shoot-variable-name must follow the standard naming convention described in Rules for variable names.

VALUE=point-and-shoot-value | %varname | *

This attribute provides the value to be placed in the field specified by the VAR attribute. You can define this attribute as a variable name preceded by a “%”. To specify a blank value, the "' '" (quotation mark, apostrophe, blank, apostrophe, quotation mark) coding notation should be used.

When the PS tag is used with the CHOICE tag, VALUE=* can be used to automatically use the current choice number (or SELCHAR value) as the point-and-shoot selection value.

CSRGRP=NO | YES | n

When CSRGRP=YES, the conversion utility generates a cursor group number to be used for this point-and-shoot text field. When CSRGRP=n, the number provided is used for this field.

DEPTH=n | %varname

This attribute defines the depth reserved for the point-and-shoot field. When the panel is displayed in GUI mode, the resulting push button is displayed with the specified DEPTH. You use this attribute in combination with the IMAPNAME attribute to provide space for the image. The minimum value is 1 and the maximum value is the remaining panel depth.

IMAPNAME=image-name | %varname

This attribute specifies the name of a image to be placed on the point-and-shoot push button when it is displayed in GUI mode. The image-name is not used when the panel is displayed in host mode.

The image-name must follow the standard naming convention described in Rules for variable names.

IMAPNAMEP=image-namep | %varname: This attribute specifies the name of a image to be placed on the point-and-shoot push button after it has been pushed when it is displayed in GUI mode. The image-namep is not used when the panel is displayed in host mode.
The image-namep must follow the standard naming convention described in Rules for variable names.
PLACE=ABOVE | BELOW | LEFT | RIGHT | %varname: This attribute specifies the position of the image relative to the text within the point-and-shoot push button.

point-and-shoot-text

This is the text of a point-and-shoot entry.

Comments

The PS tag is valid as part of the text following these tags:

INFO TAGS: ATTENTION, CAUTION, DD, DDHD, DT, DTHD, FIG, FIGCAP, H2, H3, H4, LI, LINES, LP, NOTE, NT, P, PD, PT, WARNING, and XMP.
PANEL TAGS: BOTINST, CHOFLD, CHOICE, DTAFLD, DTAFLDD, GRPHDR, LSTCOL, LSTGRP, PNLINST, SELFLD, and TOPINST.

The point-and-shoot-text is color emphasized within the text of the panel. When running in GUI mode, the point-and-shoot-text displays as a push button. For host displays, the user places the cursor on the point-and-shoot-text and presses ENTER to select the option.

Restrictions

The PS tag requires an end tag.
When a "%varname" notation is found on any of the attributes that allow a variable name, the "%varname" entry must follow the standard naming convention described in Rules for “%variable” names.

Processing

None.

Examples

Here is an example that shows the use of point-and-shoot selection for a sample option menu. Figure 1 shows the formatted result.

<!doctype dm system ()>
<!-- Sample selection menu with point-and-shoot -->
<panel name=ps1 menu keylist=keylxmp>Sample Point-and-Shoot
  <topinst>This is a selection panel.
  <selfld type=menu   pmtloc=before
          selwidth=40 pmtwidth=10>Select an option
    <choice checkvar=xtest1 match=a>
        <PS VAR=zcmd VALUE=1>Selection #1 (Command Tstch1)
</PS>
      <action run=tstch1 parm='1 2 3 4'
       passlib newpool suspend>
    <choice checkvar=xtest1 match=b>
        <PS VAR=zcmd VALUE=2>Selection #2 (Command Tstch2)
</PS>
      <action run=tstch2 parm=1234>
    <choice checkvar=xtest1 match=c>
        <PS VAR=zcmd VALUE=3>Selection #3 (Command Tstch3)
</PS>
      <action run=tstch3 parm=abcd>
    <choice checkvar=xtest1 match=d>
        <PS VAR=zcmd VALUE=4>Selection #4 (Command Tstch4)
</PS>
      <action run=tstch4 parm='a b c d'>
  </selfld>
  <cmdarea>
</panel>

Figure 1. Point-and-shoot fields

                         Sample Point-and-Shoot

 This is a selection panel.

 Select an
 option . . 1  Selection #1 (Command Tstch1)
            2  Selection #2 (Command Tstch2)
            3  Selection #3 (Command Tstch3)
            4  Selection #4 (Command Tstch4)










 Option ===> _____________________________________________________________
  F1=Help        F3=Exit        F5=Display     F6=Keyshelp   F10=Actions
 F12=Cancel