Dialog Boxes and Property Sheets Prosise, Chapter 8

1. Dialog Boxes and Property SheetsProsise, Chapter 8 Jim Fawcett CSE681 – Advanced Windows Programming Summer 2003 Derived from a presentations by Kevin Devaney and Ciahua Wang

2. Dialog Boxes • Modal • Owner window disabled until dialog closed • Modeless • Owner window can be reactivated while dialog is still open • Property Sheets • Dialog boxes with tabbed pages

3. Class Hierarchy

4. Example Dialog Box • Font dialog • Controls • Combo boxes • List boxes • Check boxes • Push buttons

5. Create a Simple Dialog App • Use MFC AppWizard • Visual C++ Menu • File / New / MFC AppWizard • “Step 0” - Define project name and location • Step 1 – Choose “Dialog-based” • Other Steps – Accept defaults

6. Using MFC AppWizard

7. Add Dialog Controls • Use toolbar to select controls for your dialog • Click on the control you want • Click on the dialog where you want to put the control • Drag mouse on edges of the control to resize it • Right-click on control, select properties and provide new ID

8. Creating MFC Dialog Application

9. Selecting Application Type

10. Resource Editor View

11. Dialog Resource File (.rc) IDD_CREDIT_DIALOG DIALOGEX 0, 0, 265, 154 STYLE DS_MODALFRAME | WS_MINIMIZEBOX | WS_POPUP | WS_VISIBLE | WS_CAPTION | WS_SYSMENU EXSTYLE WS_EX_APPWINDOW CAPTION "Credit Card Calculator" FONT 8, "MS Sans Serif" BEGIN DEFPUSHBUTTON "Calculate",IDOK,198,102,41,14 PUSHBUTTON "Exit",IDCANCEL,198,126,41,14 CONTROL "Spin1",IDC_SPIN_DEBT,"msctls_updown32",UDS_ARROWKEYS,21,22,11,14 END Resource file has “dialog template” Dialog box characteristics (popup) Types of controls used in the dialog (spin) Control position, size, characteristics

12. Adding Shortcut Keys &Exit Right-click on control and select Properties Alt-E will activate the Exit button

13. Setting Tab Order In Visual C++ menu, choose Layout/Tab Order Current tab order will be shown Click on controls in desired order to set a new tab order

14. Responding to User Input • Double-click on the control • Creates the “default” event handler, e.g., OnEnChangeEdit1 for EditBox. • To get more choices right click and select add event handler. • Add code to handler function to perform needed processing

15. Adding an Event Handler

16. Temperature Converter IDC_EDIT_INPUT IDC_EDIT_OUTPUT

17. OnOK Processing

18. How to talk to controls - 1 • Use CWnd functions • GetDlgItemText, SetDlgItemText • CheckRadioButton, GetCheckedRadioButton • CheckDlgButton, IsDlgButtonChecked • This was illustrated in Temperature Converter example

19. How to talk to controls - 2 • Use info supplied in the message handler

20. How to talk to controls - 3 • Use common control classes • CEdit, CListBox, CComboBox, CSliderCtrl, etc • Use CWnd Attach function to associated control class with your control

21. Common Control Class Example Remember to use Detach function if you create the object on the stack

22. How to talk to controls - 4 • Use Dynamic Data Exchange • Override virtual function DoDataExchange • Use DDX functions to associate member variables with controls • Exchange occurs: Input (variable to control) in OnInitDialog Output (control to variable) in OnOK

23. DDX Example

24. DDX Functions DDX_Text Edit control DDX_Check Check box DDX_Radio Radio box DDX_LBIndex, DDX_LBString List box DDX_CBIndex, DDX_CBString Combo box DDX_Scroll Scroll bar

25. Dynamic Data Validation • Dynamic data validation (DDV) works similar to DDX • DDV checks that input data is within specified limits • If data is outside limits, focus is passed to the control and an error message is displayed

26. DDV Example

27. DDV Functions DDV_MinMaxByte, DDV_MinMaxInt, DDV_MinMaxLong, DDV_MinMaxUInt, DDV_MinMaxDWord, DDV_MinMaxFloat, DDV_MinMaxDouble, DDV_MaxChars

28. Modal vs Modeless • Modal • Display dialog by calling CDialog::DoModal • Exit by calling CDialog::OnOK or OnCancel • Usually instantiated on the stack so destruction is automatic

29. Modal vs Modeless • Modeless • Display dialog by calling CDialog::Create • Exit dialog by calling DestroyWindow • Don’t call OnOK or OnCancel • Usually instantiated on the heap (new) so the dialog is not destroyed prematurely • Make sure dialog is deleted by overriding CDialog::PostNcDestroy function using “delete this” statement

30. Basic Modal Dialog Programming (see example p. 398) • Declare dialog member variables in header file (.h) • Initialize variables and setup controls in OnInitDialog • Use Class Wizard to create message handler functions that get user input • Perform data processing in OnOK andcomment out call to Cdialog::OnOK()

31. Property Sheets • Tabbed dialog boxes • User can switch between pages using mouse • MFC classes • CPropertySheet • CPropertyPage

32. How to Create a Modal Property Sheet • For each page create a dialog template. • For each page derive a dialog-like class from CPropertyPage that includes members linked to the page’s controls via DDX or DDV. • Derive a property sheet class from CPropertySheet. • Use CPropertySheet::AddPage() to add pages to the property sheet. • Call the property sheet’s DoModal() to display the property sheet.

33. How to Create a Modal Property Sheet (cont.) • MFC CPropertySheet provides functions for three buttons -- OK, Cancel and Apply. • Property sheet pages should not include OK or Cancel button --when the property sheet’s OK button is clicked, the current page’s OnOK() is called. • Add message handler for Apply button, which should call the active page’s UpdateData(TRUE). • Use CPropertyPage’s SetModified() to enable or disable Apply button.

34. How to Create a Modal Property Sheet (cont.) class CFirstPage:public CPropertyPage{ public: …. // delare member here protected: virtual void DoDataExchange(CDataExchange*); …. }; class CMyPropertySheet:public CProperySheet{ public: …. CFirstPage m_firstPage; // first page ….. CMyPropertySheet(…){ // constructor AddPage(&m_firstPage); …. } };

35. Common Dialogs CFileDialog CPrintDialog CPageSetupDialog CFindReplaceDialog CColorDialog CFontDialog

36. CFileDialog

37. CFileDialog code TCHAR szFilters[] = _T( "Text files (*.txt)|*.txt|All files (*.*)|*.*||“ ) CFileDialog dlg(TRUE, _T("txt"), _T("*.txt"), OFN_FILEMUSTEXIST | OFN_HIDEREADONLY, szFilters); if( dlg.DoModal() == IDOK ) { filename = dlg.GetPathName(); }