Класс CPropertySheet
Класс CPropertySheet инкапсулирует возможности управления многостраничным диалогом.
Класс CPropertySheet предоставляет ряд методов, включая следующие:
- GetActiveIndex - метод возвращает индекс текущей страницы свойств.
- GetPageCount - метод возвращает количество страниц свойств в окне набора свойств.
- GetPage - метод возвращает указатель на страницу свойств, заданную по индексу.
- GetActivePage - метод возвращает указатель на текущую активную страницу свойств.
- SetActivePage - метод устанавливает новую текущую активную страницу.
Например:
BOOL CMySheet::OnInitDialog() // Класс CMySheet //наследует от CPropertySheet { BOOL bResult = CPropertySheet::OnInitDialog(); CFrameWnd* frame = (CFrameWnd*) AfxGetMainWnd(); CPSheetDoc* doc = (CPSheetDoc*) frame->GetActiveDocument(); SetActivePage(doc->m_LastActivePage); // Устанавливаем // текущей последнюю активную страницу return bResult; } BOOL CMyPropertySheet::OnCommand(WPARAM wParam, LPARAM lParam) { if (LOWORD(wParam) == IDOK) { CFrameWnd* frame = (CFrameWnd*) AfxGetMainWnd(); CPSheetDoc* doc = (CPSheetDoc*)frame->GetActiveDocument(); // Сохранение индекса последней активной страницы: doc->m_LastActivePage = GetPageIndex(GetActivePage()); // Или GetActiveIndex() } return CPropertySheet::OnCommand(wParam, lParam); }
- SetTitle - метод устанавливает заголовок для окна набора свойств;
- GetTabControl - метод возвращает указатель на объект класса CTabCtrl, обеспечивая доступ к элементу управления "вкладка".
- SetFinishText - метод устанавливает текст, отображаемый на командной кнопке Finish, и делает ее доступной.
- SetWizardButtons - метод устанавливает доступные командные кнопки для мастера, которые задаются комбинацией следующих флажков: PSWIZB_BACK, PSWIZB_NEXT, PSWIZB_FINISH, PSWIZB_DISABLEDFINISH.
- SetWizardMode - метод устанавливает, что окно набора свойств будет мастером (при отображении окна вызовом метода DoModal возвращаемые значения будут ID_WIZFINISH или IDCANCEL).
Например:
CPropertySheet dlg; CPropertyPage page1, page2; dlg.AddPage(&page1); dlg.AddPage(&page2); dlg.SetWizardMode(); dlg.DoModal();
- AddPage - метод добавляет в окно набора свойств указанную страницу свойств;
- RemovePage - метод удаляет указанную страницу свойств из окна набора свойств;
- PressButton - метод имитирует выбор в окне набора свойств указанной командной кнопки.