SetProp

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

(BOOL SetProp HWND  hWnd, / / обработать окнаLPCTSTRlpString, / / atom или адрес строкиОБРАБАТЫВАТЬhData / / обработки данных);
 

Параметры

hWnd

Дескриптор окна, чьи свойства списка получает новую запись.

lpString

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

hData

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

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

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

Если вызов функции был неуспешен, возвращаемое значение равно нулю. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.

Примечания

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

QuickInfo

nbsp; Windows &NT: требует версии 3.1 или более поздней версии.
Windows:Требует Windows 95 или более поздней версии.
Windows CE:Не поддерживается.
Заголовок:Объявленные в winuser.h.
Импорта библиотеки:Используйте user32.lib.
Юникод:В версии Юникода и ANSI в Windows NT.

Родственные слова

Обзор свойств окна, окно Свойства функции, EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp

Index