SetProp

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

(BOOL SetProp HWND  hWnd, / / ручка вікнаLPCTSTRlpString, / / атома або адреси рядкаРучкаhData / / ручка дані);
 

Параметри

hWnd
Ручки для вікна, перелік яких властивість отримує новий запис.
lpString
Вказівник на рядок із нульовим або містить atom, що визначає рядок. Якщо цей параметр атома, вона повинна бути глобальної atom, створені попередній виклик на GlobalAddAtom функції. Atom, 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