Функции поддержки окон. Данные класса окна., страница 4

EnumProps                                      • Windows 98   • Windows 2000

Описание

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

Синтаксис

int EnumProps( HWND hwnd, PROPENUMPROC IpEnumFunc )

П араметры

hwnd

HWND. Дескриптор окна со списком свойств, которые должны быть перечислены.

IpEnumFunc

PROPENUMPROC. Указатель на функцию обратного вызова, определенную в приложении.

Возвращаемое значение

int. Последнее значение, возвращенное функцией обратного вызова. Возвращаемым значением является -1, если с окном не связаны элементы свойств.

Включаемый файл

winuser.h

См. также

EnumPropsEx, EnumChildWindows, Set Prop, GetProp, RemoveProp

Синтаксис обра

iTHoro вызова

BOOL CALLBACK EnumPropProc( HWND hwnd, LPCTSTR IpszString, HANDLE hData )

Параметры обратного вызова

hwnd

HWND. Дескриптор окна, с которым связан элемент свойств.

IpszString

LPCTSTR. Указатель на строку с нулевым символом в конце или целочисленное атомарное значение, которое применялось с функцией SetProp для указания элемента свойств. Если использовалось атомарное значение, старшее слово должно быть установлено в 0, а младшее — должно содержать это значение.

hData

HANDLE. Дескриптор данных элемента свойств.

Возвращаемое знамение обратного вызова

BOOL. TRUE — для продолжения перечисления; FALSE — для прекращения перечисления.

Пример

В следующем примере происходит добавление трех свойств к главному окну приложения. Затем для перечисления этих свойств и отображения значения каждого свойства в окне сообщения применяется функция EnumProps.

См.    /Iocal-sourcas/chap04/04-10.txt

EnumPropsEx                                    • Windows 98   • Windows 2000

Описание

Функция EnumPropsEx аналогична функции EnumProps, за исключением того, что она имеет дополнительный параметр для передачи в функцию обратного вызова данных, определенных в приложении.

Синтаксис

int EnumPropsEx( HWND hwnd, PROPENUMPROCEX IpEnumFunc,

Параметр!»

hwnd

HWND. Дескриптор окна со списком свойств, которые должны быть перечислены.

IpEnumFunc

PROPENUMPROCEX. Указатель на функцию обратного вызова, определенную в приложении.

IParam

LPARAM. Определенное в приложении 32-разрядное значение, которое должно быть передано в функцию обратного вызова для каждого элемента свойств.

Возвращаемое значение

int. Последнее значение, возвращенное функцией обратного вызова. Возвращаемым значением является -1, если окно не имело связанных с ним элементов свойств.

Включаемый файл

winuser.h

См. также

EnumProps, SetProp, GetProp, RemoveProp

Синтаксис обратного вызова

BOOL CALLBACK PropEnumProcEx( HWND hwnd, LPCTSTR IpszString, HANDLE hData, ULONG_PTR dwData )

Параметры обратного вызова

hwnd

HWND. Дескриптор окна, с которым связан элемент свойств.

IpszString

LPCTSTR. Указатель на строку с нулевым символом в конце или целочисленное атомарное значение, которое применялось с функцией SetProp для указания элемента свойств. Если использовалось атомарное значение, старшее слово должно быть установлено в 0, а младшее — должно содержать это значение.

hData

HANDLE. Дескриптор данных элемента свойств.

dwData

ULONG_PTR. Значение, определяемое в приложении, которое используется в параметре IParamвызова функции EnumPropsEx.

Возвращаемое значение обратного вызова

BOOL. Возвращает TRUE для продолжения перебора списка свойств. Возвращает FALSE для прекращения перебора списка свойств.

Пример

Аналогичен примеру для EnumProps, за исключением того, что имя последнего перечисленного элемента свойств копируется в буфер, на который указывает параметр IParam, а затем отображается в окне сообщения.

См.    /local -sources/chap04/04-ll . fact

EnumThreadWindows                       • Windows 98   •  Windows 2000

Описание

Функция EnumThreadWindows посылает дескриптор каждого окна, принадлежащего нити, функции обратного вызова, определенной в приложении. Функция EnumThreadWindows выполняется до тех пор, пока не будут обработаны все окна, связанные с нитью, или пока функция обратного вызова не возвратит значение FALSE.

Синтаксис

BOOL EnumThreadWindows( DWORD dwThreadld, WNDENUMPROC Ipfii, LPARAM IParam )

Параметры

dwThreadld

DWORD. Идентификатор нити, для которой должны быть перечислены окна.

Ipfr

WNDENUMPROC. Указатель на функцию обратного вызова, определенную в приложении.

IParam

LPARAM. Определенное в приложении 32-разрядное значение, которое должно быть отправлено функции обратного вызова для каждого окна в нити.

Возвращаемое значение

BOOL. TRUE, если функция была выполнена успешно, и FALSE в противном случае.

Включаемый файл

winuser.h

См. также

EnumChildWindows, GetWindowThreadProcessId, EnumWindows, GetCurrentThreadld

Синтаксис обратного вызова

BOOL CALLBACK EnumThreadWndProc( HWND hwnd, LPARAM IParam )

Параметры обратного вызова

hwnd

HWND. Дескриптор окна, связанного с нитью, которая указана в функции EnumThreadWindows.

IParam

LPARAM. Определенное в приложении 32-разрядное значение, которое передано функции EnumThreadWindows.

Возвращаемое значение обратного вызова

BOOL. TRUE — для продолжения перечисления; FALSE — для прекращения перечисления.

Пример

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