General Dialog Functions

 

These functions, most of which take a control id as an argument, assume the dialog handle is contained in the IB variable cosDlghDlg$.

 

 

COS.DlgMessageBox†††††††††† Displays a message box with a dialog parent

 

On Entry:††††††††† <cosState>†††††††††††††††††† Specifies the contents and behavior of the

dialog box. SEE COS.MessageBox

 

††††††††††† < cosCtlText$>††††††††††† contains the message box text

 

††††††††††††††††††††††† <cosSysData$>††††††††††† contains the message box caption

 

On Exit:††††††††††† <cosFuncResult>††††††††† contains the ID of the control that caused the

dialog to close.SEE COS.MessageBox

 

 

COS.GetDlgItemTextLength Returns the length of a dialog (or window) controlís text

 

On Entry:††††††††† <cosCtlId>†††††††††††††††††† contains the control ID

 

On Exit:††††††††††† <cosFuncResult>††††††††† contains the length of he text

 

 

COS.GetDlgItemText - Retrieves text contained in the specified dialog (or window) specified control

 

On Entry:††††††††† <cosCtlId>†††††††††††††††††† contains the control ID

 

On Exit:††††††††††† <cosCtlText$> contains the control text

 

 

COS.SetDlgItemText - Sets the text in a specified dialog (or window) control

 

On Entry:††††††††† <cosCtlId>†††††††††††††††††† contains the control ID

 

††††††††††† <cosCtlText$> contains the text to be copied

On Exit:

 


COS.SetDlgItemFocus - Sets the input focus to the specified dialog (or window) control

 

On Entry:††††††††† <cosCtlId>†††††††††††††††††† contains the control ID

 

On Exit:††††††††††† <cosCWnd$>contains a handle to the window that previously

had the focus or NullWord$ if the function failed

 

 

COS.EnableDlgItem - Enables/disables a dialog (or window) control

 

This function enables or disables mouse and keyboard input to the given window or control. When input is disabled, the window ignores input such as mouse clicks and key presses. When input is enabled, the window processes all input.

 

On Entry:††††††††† <cosCtlId>†††††† contains the control ID

 

<cosState> ††††††††††††††††† contains the desired state as follows:

cosEW.ENABLE (1)- Enables control

cosEW.DISABLE (0) - Disables control

 

On Exit:††††††††††† <cosFuncResult>††††††††† nonzero if the window was previously disabled.

Otherwise, the return value is zero

 

 

COS.GetDlgItem - Retrieves the handle of a dialog (or window) control

 

On Entry:††††††††† <cosCtlId>†††††††††††††††††† contains the control ID

 

On Exit:††††††††††† <cosCWnd$>contains a handle to the window or NullWord$

if the function failed

 


COS.ShowDlgItem - Specifies how a dialog control is to be shown

 

On Entry:††††††††† <cosCtlId>†††††††††††††††††† contains the control ID

 

<cosCtlId> contains the control ID

 

<cosState> contains the desired state as follows:

SW.HIDE

SW.SHNORMAL

SW.NORMAL

SW.SHMINIMIZE

SW.SHMAXIMIZE

SW.MAXIMIZE

SW.SHNOACTIVATE

SW.SHOW

SW.MINIMIZE

SW.SHMINNOACTIVATE

SW.SHNA

SW.RESTORE

 

On Exit:††††††††††† < cosFuncResult >††††††† nonzero if the window was previously visible. It

is zero if the window was previously hidden.