470

•В наборах страниц свойств, использующих ресурсы (такие как значки), параметр hInstance идентифицирует модуль, из которого загружаются ресурсы.

•Набор страниц свойств может иметь, а может и не иметь, значок, идентифицируемый либо описателем hIcon (требует установки флага PSH_USEHICON в поле dwFlags), либо ресурсом значка pszIcon (требует установки флага PSH_USEICONID в поле dwFlags).

•Заголовок набора страниц свойств задается строкой pszCaption.

•Число страниц свойств в наборе (т. е. размер массива страниц свойств) равен nPages.

•Первая страница свойств для отображения задается или nStartPage (индекс с нулевой базой), или заголовком первой отображаемой страницы pStartPage (требует установки флага PSH_USEPSTARTPAGE

в поле dwFlags).

•Страницы свойств набора определяются с использованием массива одного из двух типов. Первый — массив описателей страниц свойств, возвращаемых функциями CreatePropertySheetPage (по умолчанию), идентифицируемый phpage. Второй — массив структур типа PROPSHEETPAGE (требует установки флага PSH_PROPSHEETPAGE в поле dwFlags), идентифицируемый ppsp.

•В добавок к диалоговым процедурам каждой страницы свойств набор страниц свойств в целом может иметь функцию обратного вызова, которая вызывается перед тем, как создается любая из страниц свойств. Эта функция идентифицируется pfnCallback.

Параметр dwFlags обеспечивает тонкую настройку набора страниц свойств. Некоторые флаги показывают, будет ли тот или иной член структуры PROPSHEETHEADER использоваться или игнорироваться. В предыдущем листинге этой структуры конкретные члены помечены именами соответствующих флагов. Другие флаги приведены в следующей таблице:

Функция PropertySheet

Функция, которая действительно создает набор страниц свойств, называется PropertySheet. Она принимает единственный параметр: указатель на структуру типа PROPSHEETHEADER. Набор страниц свойств, по умолчанию, является модальным, поэтому функция PropertySheet возвращает TRUE, когда пользователь нажимает кнопку OK, и FALSE, когда пользователь нажимает кнопку Cancel. Вызов функции PropertySheet выглядит как обычный вызов функции DialogBox:

if(PropertySheet(&pshead))

{

[пользователь нажал OK – сохранить изменения]

}

else

{

[пользователь нажал Cancel – отменить изменения]

}

Для создания немодального набора страниц свойств используется функция PropertySheet с установленным флагом PSH_MODELESS в структуре заголовка набора страниц свойств. Вместо возврата значения типа Boolean функция PropertySheet возвращает описатель окна набора страниц свойств:

// Создание немодального набора страниц свойств. Возвращается описатель окна

HWND hwndPropSheet =(HWND) PropertySheet(&pshead);

Процедуры диалогового окна страницы свойств

Каждая страница свойств имеет собственную диалоговую процедуру. При создании страницы свойств диалоговая процедура получает сообщение WM_INITDIALOG и инициализирует элементы управления страницы. Набор страниц свойств не создает страницу свойств до тех пор, пока она не понадобится. Поэтому, конкретная страница

472

Важнейшим из этих уведомлений является PSN_APPLY, означающее, что пользователь нажал кнопку OK или Apply. Внесенные изменения должны быть приняты. Это уведомление заменяет сообщение WM_COMMAND с идентификатором IDOK в обычном окне диалога. В отличие от обычного диалога, однако, функция EndDialog не вызывается для диалогового окна страницы свойств (это могло бы привести к порче окна набора страниц свойств). Сам набор страниц свойств отвечает за создание и удаление страниц свойств.

Уведомление PSN_APPLY посылается при нажатии на кнопку OK или Apply. В большинстве случаев пользователь почти не различает эти кнопки по смыслу. Однако, ситуация меняется, если окно набора страниц свойств — немодальное. При нажатии на кнопку OK набор страниц свойств должен быть уничтожен. Ниже приведен соответствующий фрагмент программы:

// Проверка при работе с немодальным окном набора страниц свойств if( IsWindowEnabled(hwndMain) )

{

LPPSHNOTIFY psh =(LPPSHNOTIFY)lParam; HWND hwndPropSheet;

//Нажатие на кнопку Apply не означает удаления if(pnmh->code == PSN_APPLY && psh->lParam == 0)

return TRUE;

//Нажатие на кнопку OK или Cancel означает удаление hwndPropSheet = GetParent(hwndDlg); DestroyWindow(hwndPropSheet);

hwndModeless = NULL;

}

Уведомляющие сообщения PSN_APPLY и PSN_RESET являются широковещательными, т. е. они посылаются всем активным и неактивным страницам свойств набора, с одним только ограничением: страница свойств должна уже быть создана. Поскольку страница свойств в наборе создается только тогда, когда пользователь ее активизирует, возможно, и достаточно часто, встречается случай, что диалоговая процедура страницы свойств не получает сообщения WM_NOTIFY. На практике это означает, что диалоговое окно страницы свойств будет всегда получать сообщение WM_INITDIALOG до того, как получит сообщение WM_NOTIFY.

Управление набором страниц свойств

Управление набором страниц свойств состоит в посылке ему сообщений. Для этого необходимо получить описатель окна набора страниц свойств. Диалоговые процедуры страниц свойств получают описатель конкретной страницы, которая является дочерним окном всего набора страниц свойств. Для получения описателя окна набора страниц свойств необходимо вызвать функцию GetParent:

// Получить описатель окна набора страниц свойств

HWND hwndPropSheet = GetParent(hwndDlg);

Используя этот описатель, можно посылать сообщения набору страниц свойств с помощью функции SendMessage или с использованием макросов сообщений из файла PRSHT.H.

474

изменений состоит в посылке сообщения родительскому окну с запросом о применении изменений. Этот путь отличается от пути, которым обрабатывается модальное диалоговое окно в обычной Windows-программе, когда изменения применяются только после завершения функции DialogBox. Фактически, это более похоже на метод обработки изменений, применяемый при работе с немодальными диалоговыми окнами.

Уведомления о нажатии на кнопку OK и кнопку Apply — одинаковы. Диалоговые процедуры открытых страниц свойств — страниц, которые были хоть раз активизированы пользователем и получили сообщение WM_INITDIALOG — получают сообщение WM_NOTIFY с кодом уведомления PSN_APPLY. Разумным ответом является сохранение, когда-либо сделанных изменений, и посылка сообщения своему родительскому окну.

Чтобы сделать окно набора страниц свойств более похожим на модальное диалоговое окно, делайте кнопку Apply недоступной, создавая набор страниц свойств с установленным флагом PSH_NOAPPLYNOW. (Раньше кнопка имела название "Apply Now".) Применение изменений требует, в этом случае, анализа значения, возвращаемого функцией PropertySheet: TRUE — при нажатии кнопки OK, FALSE — при нажатии кнопки Cancel.

Помощь при работе с набором страниц свойств

Существует два механизма для запроса помощи при работе с набором страниц свойств: кнопка Help и клавиша <F1>. Кнопка Help отображается только в наборах страниц свойств, созданных с установленным флагом PSH_HASHELP, но остается недоступной до тех пор, пока не будет активизирована страница свойств с установленным флагом PSP_HASHELP. Нажатие на кнопку Help приводит к посылке сообщения WM_NOTIFY с кодом уведомления PSN_HELP диалоговой процедуре страницы свойств. Вам следует реагировать на это сообщение, отображая окно помощи со вспомогательной информацией о конкретной странице свойств.

Любое Win32-окно поддерживает клавишу помощи <F1>. Оконная процедура по умолчанию отвечает на необработанные нажатия клавиши <F1>, посылая сообщение WM_HELP родительскому окну. Поэтому, никакой специальной обработки нажатия клавиши <F1> не требуется, кроме обработки сообщения WM_HELP.

Обработка немодального набора страниц свойств

Также как большинство диалоговых окон, большинство наборов страниц свойств — модальные. Если вы решите создать немодальный набор страниц свойств, потребуются небольшие изменения. Во-первых, необходимо указать флаг PSH_MODELESS в структуре PROPSHEETHEADER. Все другие изменения аналогичны тем, какие надо сделать для создания немодального диалогового окна.

Чтобы разрешить интерфейс клавиатуры для немодального диалогового окна, вы вызываете функцию IsDialogMessage. Эта функция фильтрует клавиатурные сообщения в цикле обработки сообщений. При получении клавиатурного сообщения элемент управления, имеющий фокус ввода, получает сообщение WM_GETDLGCODE. Смысл сообщения состоит в запросе: "Какой тип клавиатурного ввода вам нужен?" На основе ответа элемент управления может получить ввод от клавиатуры или, в ответ на нажатие клавиш <Tab>, <Alt> + мнемоника, управления курсором, потерять фокус ввода, который перейдет к следующему по порядку элементу управления диалогового окна.

В немодальных наборах страниц свойств вместо вызова функции IsDialogMessage родительскому окну окна набора страниц свойств посылается сообщение PSM_ISDIALOGMESSAGE. Программа, имеющая немодальный набор страниц свойств, должна иметь примерно такой цикл обработки сообщений:

while(GetMessage(&msg, NULL, 0, 0))

{

if((hwndModeless) &&(!(PropSheet_IsDialogMessage(hwndModeless, &msg)))) continue;

TranslateMessage(&msg);

DispatchMessage(&msg);

}

В этом фрагменте предполагается, что hwndModeless либо равен описателю немодального окна набора страниц свойств, если он существует, либо равен NULL, если набор страниц свойств не существует.

Установка кнопок мастера

При создании мастера вместо набора страниц свойств диалоговая процедура для каждой страницы свойств должна управлять кнопками мастера. Набор страниц свойств имеет кнопки OK и Cancel, а мастер — кнопки Back и Next. Обе кнопки остаются доступными до тех пор, пока вы их явно не запретите. На последней странице мастера пользователь ожидает увидеть кнопку Finish на месте кнопки Next.

Для управления установкой кнопок мастера, посылайте ему сообщение PSM_SETWIZBUTTONS с параметром lParam, равным комбинации трех значений: PSWIZB_NEXT, PSWIZB_BACK, PSWIZB_FINISH. Удобный момент