SetCBFlags Method (COMBOBOX)


PLBCMP GUI Only, 10.3

 

The SetCBFlags method controls specialized behaviors for a COMBOBOX object. The method uses the following format:

 

[label]

{object}.SetCBFlags

[GIVING {return}] USING [*FLAGS=]{flags},*MODE={mode}

 

Where:

label

Optional. A Program Execution Label.

object

Required. A COMBOBOX object that is accessed.

return

Optional. A Numeric Variable that contains the last flags bit mask value before this method is executed.

flags

Required. A decimal number or Numeric Variable that is a bitmask value from 0x0000 to 0xFFFF.

mode

Required. A decimal number or Numeric Variable that specifies the type of operation performed by the method.

Flags Affected: EOS, OVER, ZERO

Note the following:

  1. If the {mode} value is zero, the state flags defined by the {flags} value are cleared for the COMBOBOX object. If the {mode} value is non-zero, the state flags defined by the {flags} value are set to take affect for the COMBOBOX object.

  2. Each bit it the {flags} bitmask value defines a specialized behavior for a COMBOBOX object as defined below:

  3.  

    Value

    Behavior

    0x1

    Causes the list to be dropped/shown when a COMBOBOX gets focus.

    0x2

    A CLICK/DEFAULT event is not generated on a selection change.

  1. If the value returned is zero, the ZERO Condition Flag is set.

  2. The OVER and EOS Condition Flags are always cleared.

  3. For improved performance in the Application Server environment, do not specify the optional return value unless needed.

 

 

See Also: Method Syntax, COMBOBOX Methods

 



PL/B Language Reference SetCaretIndex Method (DATALIST) SetCurSel Method (COMBOBOX / DATALIST)