SetProp

Funksjonen SetProp legger til en ny oppføring eller endrer en eksisterende oppføring i egenskap-listen i det angitte-vinduet. Funksjonen legger til en ny oppføring i listen hvis den angitte strengen ikke finnes allerede i listen. Den nye posten inneholder strengen og håndtak. Ellers erstatter funksjonen Strengens gjeldende håndtak med den angitte referansen.

() BOOL SetProp HWND  hWnd, / / håndtere-vinduetLPCTSTRlpString, / / atom eller adressen til strengHåndterehData / / håndtere data);
 

Parametere

hWnd

Håndtere til vinduet som har egenskapslisten mottar ny oppføring.

lpString

Pekeren til en null-terminert streng eller inneholder et atom som identifiserer en streng. Hvis denne parameteren er en atom, det må være en global atom som er opprettet av et tidligere anrop til de GlobalAddAtom -funksjonen. Atom, en 16-biters verdi, må plasseres i signifikante ordet av lpString; signifikante ordet må være null.

hData

Håndtere til dataene skal kopieres til egenskapslisten. Håndtaket data kan identifisere noen verdi som er nyttig for programmet.

Returverdier

Hvis dataene håndtaket og streng er lagt til i egenskapslisten, er returverdien ikke-null.

Hvis funksjonen mislykkes, er verdien som returneres Null. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Før ødelegge et vindu (det vil si før behandles WM_DESTROY meldingen), et program må fjerne alle oppføringer den lagt til i egenskapslisten. Programmet må bruke RemoveProp -funksjonen til å fjerne oppføringene.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner på Windows NT.

Se også

Vinduet Utskriftsegenskaper, oversikt, Window-egenskapen fungerer, EnumProps, EnumPropsEx, GetProp, GlobalAddAtom, RemoveProp

Index