На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

PROPSHEETPAGE



The PROPSHEETPAGE structure defines a page in a property sheet.

typedef struct _PROPSHEETPAGE { // psp
DWORD dwSize;
DWORD dwFlags;
HINSTANCE hInstance;
union {
LPCTSTR pszTemplate;
LPCDLGTEMPLATE pResource;
};
union {
HICON hIcon;
LPCTSTR pszIcon;
};
LPCTSTR pszTitle;
DLGPROC pfnDlgProc;
LPARAM lParam;
LPFNPSPCALLBACK pfnCallback;
UINT FAR * pcRefParent;
} PROPSHEETPAGE, FAR *LPPROPSHEETPAGE;
typedef const PROPSHEETPAGE FAR *LPCPROPSHEETPAGE;



Members

dwSize

Size, in bytes, of the structure. The size includes any extra application-defined data at the end of the structure.

dwFlags

A set of bit flags that enable optional attributes of the property sheet page, and indicate the valid members of the PROPSHEETPAGE structure. This member can be a combination of the following values.

Value Meaning
PSP_DEFAULT Uses the default meaning for all structure members.
PSP_DLGINDIRECT Creates the page from the dialog box template in memory pointed to by the pResource member. The PropertySheet function assumes that the template is in writeable memory; a read-only template will cause an exception on some versions of Windows.If this flag is not set, the page loads the dialog box template from the resource identified by the pszTemplate member.
PSP_HASHELP Enables the property sheet Help button when this page is active.
PSP_USECALLBACK Calls the function specified by pfnCallback when creating or destroying the property sheet page defined by this structure.
PSP_USEHICON Uses hIcon as the small icon on the tab for the page.
PSP_USEICONID Uses pszIcon as the name of the icon resource to load and use as the small icon on the tab for the page.
PSP_USEREFPARENT Maintains the reference count specified by pcRefParent for the lifetime of the property sheet page created from this structure.
PSP_USETITLE Uses pszTitle as the title of the property sheet dialog box instead of the title stored in the dialog box template.
PSP_RTLREADING When this page is active, displays the text of pszTitle using right-to-left reading order on Hebrew or Arabic systems.


hInstance

Handle to the instance from which to load the dialog box template, icon, or title string resource.

pszTemplate

Dialog box template to use to create the page. This member can specify either the resource identifier of the template or the address of a string that specifies the name of the template. If dwFlags includes the PSP_DLGINDIRECT value, this member is ignored.

pResource

Pointer to a dialog box template in memory. The PropertySheet function assumes that the template is in writeable memory; a read-only template will cause an exception on some versions of Windows. If dwFlags does not include the PSP_DLGINDIRECT value, this member is ignored.

hIcon

Handle to the icon to use as the small icon in the tab for the page. If dwFlags does not include the PSP_USEHICON value, this member is ignored.

pszIcon

Icon resource to use as the small icon in the tab for the page. This member can specify either the identifier of the icon resource or the pointer to the string that specifies the name of the icon resource. If dwFlags does not include the PSP_USEICONID value, this member is ignored.

pszTitle

Title of the property sheet dialog box. This title overrides the title specified in the dialog box template. This member can specify either the identifier of a string resource or the pointer to a string that specifies the title. If dwFlags does not include the PSP_USETITLE value, this member is ignored.

pfnDlgProc

Pointer to the dialog box procedure for the page. The dialog box procedure must not call the EndDialog function.

lParam

Application-defined data.

pfnCallback

Pointer to an application-defined callback function that is called when the page is created and when it is about to be destroyed. For more information about the callback function, see PropSheetPageProc. If dwFlags does not include the PSP_USECALLBACK value, this member is ignored.

pcRefParent

Pointer to the reference count value. If dwFlags does not include the PSP_USERREFPARENT value, this member is ignored.



Remarks

When the PropertySheet function creates the page, the dialog box procedure for the page receives a WM_INITDIALOG message. The lParam parameter of this message points to the PROPSHEETPAGE structure used to create the page.

See Also

EndDialog, PropSheetPageProc, PropertySheet, WM_INITDIALOG


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

PROPSHEETPAGE



Структура PROPSHEETPAGE определяет страницу на листе собственности.

typedef struct _PROPSHEETPAGE { // psp DWORD dwSize;
DWORD dwFlags;
hInstance HINSTANCE;
союз {
LPCTSTR pszTemplate;
LPCDLGTEMPLATE pResource;
};
союз { HICON hIcon;
LPCTSTR pszIcon;
};
LPCTSTR pszTitle;
DLGPROC pfnDlgProc;
LPARAM lParam;
LPFNPSPCALLBACK pfnCallback;
UINT ЗНАЧИТЕЛЬНО * pcRefParent;
} PROPSHEETPAGE, ЗНАЧИТЕЛЬНО *LPPROPSHEETPAGE;
typedef const PROPSHEETPAGE ЗНАЧИТЕЛЬНО *LPCPROPSHEETPAGE;



Участники

dwSize

Размер, в байтах, структуры. Размер включает любые дополнительные определенные прикладные данные в конце структуры.

dwFlags

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

Значение Величины
PSP_DEFAULT Использует по умолчанию значение для всех структурных участников.
PSP_DLGINDIRECT Создает страницу из диалогового шаблона блока в памяти указанной, чтобы элементом pResource. Функция PropertySheet допускает что шаблон - в writeable памяти; только для чтения шаблон вызовет исключение в некоторые версии Windows.Если этот флаг не установлен, страница загружает диалоговый шаблон блока из ресурса идентифицированного элементом pszTemplate.
PSP_HASHELP Приспосабливается кнопку листовой Подсказки свойства когда эта страница активна.
PSP_USECALLBACK Называет функцию определенную pfnCallback при создании или уничтожая листовую страницу свойства определялся этой структурой.
PSP_USEHICON Использует hIcon как небольшую иконку в таб. для страницы.
PSP_USEICONID Использует pszIcon как имя иконного ресурса, чтобы загружать и использовать как небольшая иконка в таб. для страницы.
PSP_USEREFPARENT Поддерживает счет ссылки определенный pcRefParent в течение целой жизни листовой страницы свойства созданного из этой структуры.
PSP_USETITLE Использует pszTitle как название листового диалогового блока свойства вместо названия загруженного в диалоговый шаблон блока.
PSP_RTLREADING Когда эта страница активна, отображает текст pszTitle используя левое право, читающее порядок в Еврейских или Арабских системах.


hInstance

Прооперируйте пример из которого, чтобы загружать диалоговый шаблон блока, иконки или называть ресурс строки.

pszTemplate

Диалоговый шаблон блока, чтобы использоваться, чтобы создавать страницу. Этот элемент может определить или идентификатор ресурса шаблона или адрес строки, которые определяют имя шаблона. Если dwFlags включает величину PSP_DLGINDIRECT, этот элемент проигнорирован.

pResource

Указатель в диалоговый шаблон блока в памяти. Функция PropertySheet допускает что шаблон - в writeable памяти; только для чтения шаблон вызовет исключение в некоторые версии Windows. Если dwFlags не включает величину PSP_DLGINDIRECT, этот элемент проигнорирован.

hIcon

Прооперируйте иконку, чтобы использовать как небольшая иконка в таб. для страницы. Если dwFlags не включает величину PSP_USEHICON, этот элемент проигнорирован.

pszIcon

Иконный ресурс, чтобы использовать как небольшая иконка в таб. для страницы. Этот элемент может определить или идентификатор иконного ресурса или указатель в строку, которая определяет имя иконного ресурса. Если dwFlags не включает величину PSP_USEICONID, этот элемент проигнорирован.

pszTitle

Назовите листового диалогового блока свойства. Это название аннулирует название определенное в диалоговом шаблоне блока. Этот элемент может определить или идентификатор ресурса строки или указатель в строку, которая определяет название. Если dwFlags не включает величину PSP_USETITLE, этот элемент проигнорирован.

pfnDlgProc

Указатель диалоговому блоку процедуры для страницы. Диалоговый блок процедуры не должен называть функцию EndDialog.

lParam

Определенные данные Приложения.

pfnCallback

Указатель в определенную прикладную функцию возврата, которая названа когда страница создана и когда она собирается быть уничтожена. Более подробно о функции возврата, смотри PropSheetPageProc. Если dwFlags не включает величину PSP_USECALLBACK, этот элемент проигнорирован.

pcRefParent

Указатель в величину счета ссылки. Если dwFlags не включает величину PSP_USERREFPARENT, этот элемент проигнорирован.



Замечания

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

Смотри Также

EndDialog, PropSheetPageProc, PropertySheet, WM_INITDIALOG


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz