Funkcji SetProp

Funkcja funkcji SetProp dodaje nowy wpis lub zmiany istniejącego wpisu na liście właściwości określonego okna. Funkcja dodaje nowy wpis do listy, jeśli ciąg określony znak nie istnieje już na liście. Nowy wpis zawiera ciąg i uchwyt. W przeciwnym wypadku funkcja zamienia ciąg bieżące dojścia określone dojście.

(BOOL funkcji SetProp HWND  hWnd, / / uchwyt oknaLPCTSTRlpString, / / atomu lub adres ciągUchwythData / / obsługi danych);
 

Parametry

hWnd

Dojście do okna, w których listy właściwości otrzymuje nowy wpis.

lpString

Wskaźnik na ciąg zakończony wartością zerową lub zawiera atomu, który identyfikuje ciąg. Jeśli ten parametr jest atom, musi być globalne atomu utworzone przez poprzednie wywołanie GlobalAddAtom funkcji. Atom, wartość 16-bitowa, muszą być umieszczone w słowo bity lpString; program word wysokich numerach musi być równe zero.

hData

Dojście do danych mają być kopiowane do listy właściwości. Uchwyt danych można określić dowolną wartość przydatne do aplikacji.

Zwraca wartości

Jeśli dane uchwyt i ciąg są dodawane do listy właściwości, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Przed zniszczeniem okna (oznacza to, że przed przetworzeniem WM_DESTROY wiadomości), aplikacja musi usunąć wszystkie wpisy zostało ono dodane do listy właściwości. Aby usunąć wpisy aplikacji należy użyć funkcji RemoveProp.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Należy użyć user32.lib.
Unicode:Implementowane jako wersje Unicode i ANSI w systemie Windows NT.

Zobacz też

Okno właściwości omówienie, funkcje, okno właściwości, EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp

Index