SetProp

De functie SetProp wordt een nieuwe vermelding toegevoegd of gewijzigd van een bestaande vermelding in de eigenschappenlijst voor het opgegeven venster. De functie wordt een nieuwe vermelding toegevoegd aan de lijst als de opgegeven tekenreeks niet al in de lijst bestaat. De nieuwe vermelding bevat de tekenreeks en het handvat. Anders, de functie van de string huidige handvat vervangt door de opgegeven ingang.

BOOL SetProp ()  HWND  hWnd, / / verwerken van vensterLPCTSTRlpString, / / atoom of het adres van tekenreeksVerwerkenhData / / verwerken van gegevens);
 

Parameters

hWnd

Ingang naar het venster waarvan de eigenschappenlijst de nieuwe vermelding ontvangt.

lpString

Pointer naar een op null eindigende tekenreeks of een atoom waarmee een tekenreeks bevat. Als deze parameter een atoom is, het moet een globale atoom gemaakt door een eerdere aanroep van het GlobalAddAtom functie. Het Atoom, een 16-bits waarde, moet worden geplaatst in het woord van de lage-orde van lpString; de eersterangs woord moet nul zijn.

hData

Ingang naar de gegevens worden gekopieerd naar de eigenschappenlijst. De greep gegevens kan elke waarde nuttig zijn om de toepassing te identificeren.

Retourwaarden

Als de gegevens handvat en tekenreeks worden toegevoegd aan de eigenschappenlijst, is de retourwaarde aan nul.

Als de functie mislukt, is de retourwaarde nul. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Voordat het vernietigen van een venster (dat wil zeggen voordat de WM_DESTROY verwerkt bericht), een toepassing moet verwijderen alle inzendingen heeft het toegevoegd aan de eigenschappenlijst. De toepassing moet de functie RemoveProp gebruiken om de vermeldingen te verwijderen.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in winuser.h.
Bibliotheek importeren:User32.lib gebruiken.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows NT.

Zie ook

Overzicht van eigenschappen-venster, venster eigenschap functioneert, EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp

Index