CreateCaret

CreateCaret -funksjonen oppretter en ny figur for systemcirkumfleksen og tilordner eierskap av cirkumflekstegnet for det angitte vinduet. Cirkumfleks figuren er en linje, en tekstblokk eller punktgrafikk.

BOOL CreateCaret) HWND  hWnd, / / håndtere til eiervinduetHBITMAPhBitmap, / / håndtere til punktgrafikk for cirkumflekstegn figurIntnWidth, / / cirkumflekstegn breddeIntnHeight / / cirkumflekstegn høyde);
 

Parametere

hWnd
Identifiserer vinduet som eier cirkumflekstegnet.
hBitmap
Identifiserer punktgrafikken som definerer cirkumflekstegn figuren. Hvis denne parameteren er NULL, er cirkumflekstegnet solid. Hvis denne parameteren er 1 (HBITMAP), er cirkumflekstegnet grå. Hvis denne parameteren er en bitmap håndtak, er cirkumflekstegnet den angitte punktgrafikken. Punktgrafikk håndtaket må ha blitt skapt av den CreateBitmap, CreateDIBitmap, eller LoadBitmap -funksjonen.

Hvis hBitmap er en bitmap håndtak, ignorerer CreateCaret parameterne nWidth og nHeight ; punktgrafikkbildet definerer sin egen bredde og høyde.

nWidth
Angir bredden på cirkumflekstegnet i logiske enheter. Hvis denne parameteren er null, settes bredden til kantlinjebredden systemdefinerte-vinduet. Hvis hBitmap er en bitmap håndtak, ignorerer CreateCaret denne parameteren.
nHeight
Angir høyden i logiske enheter, cirkumflekstegnet. Hvis denne parameteren er null, vil høyden er satt til systemdefinerte kantlinje vindushøyden. Hvis hBitmap er en bitmap håndtak, ignorerer CreateCaret denne parameteren.

Returverdier

Hvis funksjonen lykkes, er returverdien ikke-null.

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

Merknader

Parameterne nWidth og nHeight angi cirkumflekstegnets bredde og høyde, i logiske enheter; nøyaktig bredden og høyden, i piksler, avhenger av vinduets kartlegging modus.

CreateCaret ødelegger automatisk forrige cirkumflekstegn figuren, hvis noen, uavhengig av vinduet som eier cirkumflekstegnet. Cirkumflekstegnet er skjult til programmet kaller funksjonen ShowCaret å gjøre cirkumflekstegnet synlig.

Systemet gir én cirkumflekstegn per kø. Et vindu bør opprette et cirkumflekstegn bare når det har fokus på tastaturet eller er aktiv. Vinduet skal ødelegge cirkumflekstegnet før å miste fokus på tastaturet eller å bli inaktiv.

Du kan hente bredden eller høyden av systemets vindusramme ved hjelp av funksjonen GetSystemMetrics angitt verdiene SM_CXBORDER og SM_CYBORDER. Med høyde eller bredde på vindusramme garanterer at cirkumflekstegnet vil være synlig på en skjerm med høy oppløsning.

Windows CE: Windows CE støtter ikke hBitmap parameteren og den bør settes til NULL. Windows CE som standard et solid cirkumflekstegn.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Krever versjon 1.0 eller senere.
Topptekst:Deklarert i winuser.h.
Importere biblioteket:Bruk user32.lib.

Se også

Cirkumflekstegn oversikt, cirkumflekstegn funksjoner, CreateBitmap, CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index