Button Related Dialog Functions

 

COS.CheckDlgButton - Sets the state of a specified dialog (or window) button control

 

Selects (place check mark next to) or clears (removes check mark from a button, or it changes the state of a three-state button.

 

On Entry:          <cosCtlId>                   contains the control ID

 

<cosState>                   contains the desired state as follows:

cosCDB.BTNOFF  (0) - is not checked

cosCDB.BTNON   (1) - is checked

cosCDB.BTNGRAY (2) - is grayed

 

On Exit:

 

 

COS.IsDlgButtonChecked - Gets the state of a specified button control

 

Determines whether a button control has a check mark next to it, or if three-state if is indeterminate.

 

On Entry:          <cosCtlId>                   contains the control ID

 

On Exit:            <cosState>                   contains the resulting state as follows:

cosCDB.BTNOFF  (0) - is not checked

cosCDB.BTNON   (1) - is checked

cosCDB.BTNGRAY (2) - if a thee-state button is indeterminate

 

 

COS.CheckRadioBtn - Checks one of a group of radio buttons

 

Selects the indicated radio button (turning of all others) from the specified radio button group

 

On Entry:          <cosCtlId>                   contains the first control ID of the group

 

<cosCtlIdEx>               contains the last control ID in the group

 

<cosItemId>                is the control ID to be selected.

 

On Exit:

 


COS.GetCheckedRadioBtn - Returns the currently checked radio button

 

Determine the selected radio button from the specified radio button group

 

On Entry:          <cosCtlId>                   contains the first control ID of the group

 

<cosCtlIdEx>               contains the last control ID in the group

 

On Exit:            <cosItemId> is the selected control ID

 

 

COS.LoadButtonPic  - Loads a bitmap pushbutton with custom pictures from a resource file.

 

Loads bitmap pushbutton with a specified set of pictures (from resource)

 

On Entry:          <cosCtlId>                   contains the control ID

 

<cosCtlText$>             contains a semicolon separated list of button   names representing the 4 button states as follows:

 

1st when the button is up (required).

2nd when the button is down.

3rd when the button has the input focus.

4th when the input focus is lost

 

Example: "picture1u;picture1d;picture1f;picture1x"

 

On Exit:

 


COS.AutoLoadButtonPic - Loads a bitmap pushbutton with pictures from a resource file.

 

On Entry:          <cosCtlId>                   contains the control ID

 

NOTE:  The names of each of the 4 bitmaps used are based upon the button caption followed by a letter as follows:

 

     "U" is when the button is up.

     "D" is when the button is down.

     "F" is when the button has the input focus.

     "X" is when the button loses the input focus.

 

Example: Where the button caption is "PRINT", the associated resource ID's would be:

 

     "PRINTU"

     "PRINTD"

     "PRINTF"

     "PRINTX"

 

On Exit: