На главную

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 | Скачать Вниз

SetProp



The SetProp function adds a new entry or changes an existing entry in the property list of the specified window. The function adds a new entry to the list if the specified character string does not exist already in the list. The new entry contains the string and the handle. Otherwise, the function replaces the string's current handle with the specified handle.

BOOL SetProp(

HWND hWnd, // handle of window
LPCTSTR lpString, // atom or address of string
HANDLE hData // handle of data
);


Parameters

hWnd

Identifies the window whose property list receives the new entry.

lpString

Points to a null-terminated string or contains an atom that identifies a string. If this parameter is an atom, it must be a global atom created by a previous call to the GlobalAddAtom function. The atom, a 16-bit value, must be placed in the low-order word of lpString; the high-order word must be zero.

hData

Identifies data to be copied to the property list. The data handle can identify any value useful to the application.



Return Values

If the data handle and string are added to the property list, the return value is nonzero.
If the function fails, the return value is zero.

Remarks

Before destroying a window (that is, before processing the WM_DESTROY message), an application must remove all entries it has added to the property list. The application must use the RemoveProp function to remove the entries.

See Also

EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp


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

SetProp



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

BOOL SetProp(

HWND hWnd, // РУЧКА окна LPCTSTR lpString, // атом или адрес РУЧКИ строки hData // ручка данных
);


Параметры

hWnd

Идентифицирует окно, чей список свойств получает новый вход.

lpString

Точки на недействительный расторгнутую строку или содержит атом, который идентифицирует строку. Если этот параметр является атомом, он должен быть глобальным атомом созданным предшествующим вызовом в функцию GlobalAddAtom. Атом, 16- битовая величина, должно быть установлено в младшем слове lpString; старшее слово должно - нулевым.

hData

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



Обратные Величины

Если ручка данных и строка добавлена к списку свойств, обратная величина ненулевая.
Если функция терпит неудачу, обратная величина нулевая.

Замечания

Перед уничтожать окна (то есть, перед обработкой сообщения WM_DESTROY), приложение должно удалить все данные, которые он добавил к списку свойств. Приложение должно использовать функцию RemoveProp, чтобы удалять данные.

Смотри Также

EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp


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