Skip to content

Latest commit

 

History

History
208 lines (104 loc) · 4.59 KB

PyCDialog.md

File metadata and controls

208 lines (104 loc) · 4.59 KB

PyCDialog

PyCDialog Object

A class which encapsulates an MFC CDialog object. Derived from a PyCWnd object.

Methods

  • CreateWindow

    Creates a modless window for the dialog. 

  • DoModal

    Creates a modal window for the dialog. 

  • EndDialog

    Closes a modal dialog. 

  • GotoDlgCtrl

    Sets focus to a specific control. 

  • MapDialogRect

    Converts the dialog-box units of a rectangle to screen units. 

  • OnCancel

    Calls the default MFC OnCancel handler. 

  • OnOK

    Calls the default MFC OnOK handler. 

  • OnInitDialog

    Calls the default MFC OnInitDialog handler.

sentinel 

PyCDialog.CreateWindow

CreateWindow(obParent) Create a modeless window for the dialog box.

Parameters

  • obParent=None : PyCWnd

    The parent window for the new window

MFC References

  • CDialog::CreateIndirect

PyCDialog.DoModal

int = DoModal() Create a modal window for the dialog box.

MFC References

  • CDialog::DoModal

Return Value

The return value from the dialog. This is the value passed to PyCDialog::EndDialog.

PyCDialog.EndDialog

EndDialog(result) Ends a modal dialog box.

Parameters

MFC References

  • CDialog::EndDialog

PyCDialog.GotoDlgCtrl

GotoDlgCtrl(control) Moves the focus to the specified control in the dialog box.

Parameters

  • control : PyCWnd

    The control to get the focus.

PyCDialog.MapDialogRect

(left, top, right, bottom) = MapDialogRect(rect) Converts the dialog-box units of a rectangle to screen units.

Parameters

  • rect : (left, top, right, bottom)

    The rect to be converted

PyCDialog.OnCancel

OnCancel() Calls the default MFC OnCancel handler.

See Also

PyCDialog.OnCancel Virtual

OnCancel() Called by the MFC architecture when the user selects the Cancel button.

Comments

The procedure is expected to dismiss the window with the PyCDialog::EndDialog method.

The base implementation (which dismisses the dialog) is not called if a handler exists. This can be

done via PyCDialog::OnCancel.

See Also

PyCDialog.OnInitDialog

int = OnInitDialog() Calls the default MFC OnInitDialog handler.

See Also

PyCDialog.OnInitDialog Virtual

OnInitDialog() Override to augment dialog-box initialization.

Comments

The base implementation is not called if a handler exists. This can be

done via PyCDialog::OnInitDialog.

See Also

Return Value

Specifies whether the application has set the input focus to

one of the controls in the dialog box. If OnInitDialog returns

nonzero, Windows sets the input focus to the first control

in the dialog box. The application can return 0/None only if

it has explicitly set the input focus to one of the controls in the

dialog box.

PyCDialog.OnOK

OnOK() Calls the default MFC OnOK handler.

See Also

PyCDialog.OnOK Virtual

OnOK() Called by the MFC architecture when the user selects the OK button.

Comments

The procedure is expected to dismiss the window with the PyCDialog::EndDialog method.

The base implementation (which dismisses the dialog) is not called if a handler exists. This can be

done via PyCDialog::OnOK.

See Also