CreateCaret

Funcţia CreateCaret creează o formă nouă pentru semn de omisiune nelegat sistem şi atribuie dreptul de proprietate asupra semn de omisiune nelegat de fereastra specificate. Forma semnul poate fi o linie, un bloc sau un bitmap.

(BOOL CreateCaret HWND  hWnd, / / ocupa proprietarul fereastraHBITMAPhBitmap, / / ocupa în bitmap pentru forma semn de omisiuneintnWidth, / / lăţime semn de omisiuneintnHeight / / înălţime semn de omisiune);
 

Parametrii

hWnd

Identifică fereastra care deţine semn de omisiune nelegat.

hBitmap

Identifică bitmapul care defineşte forma semnul. Dacă acest parametru este NULL, semn de omisiune nelegat este solid. Dacă acest parametru este (HBITMAP) 1, semn de omisiune nelegat este gri. Dacă acest parametru este un mâner bitmap, semn de omisiune nelegat este bitmap-ul specificat. Ghidajul bitmap trebuie să au fost create de CreateBitmap, CreateDIBitmap, sau LoadBitmap funcţie.

În cazul în care hBitmap este un mâner bitmap, CreateCaret ignoră parametrii nWidth şi nHeight ; bitmap-ul defineşte proprie lăţime şi înălţime.

nWidth

Specifică lăţimea semn de omisiune nelegat în unităţile logice. Dacă acest parametru este zero, lăţimea este setată la chenar fereastră definite de sistem. În cazul în care hBitmap este un mâner bitmap, CreateCaret ignoră acest parametru.

nHeight

Specifică înălţimea, în unită?i logice, semn de omisiune nelegat. Dacă acest parametru este zero, înăl?imea este setată la înălţimea de frontieră definite de sistem fereastra. În cazul în care hBitmap este un mâner bitmap, CreateCaret ignoră acest parametru.

Valorile întroarse

Dacă funcţia reuşeşte, valoarea returnată este nenul.

Dacă funcţia nu reuşeşte, valoarea returnată este zero. Pentru a obţine extins informa?ii eroare, apel GetLastError.

Observaţii

NWidth şi nHeight parametrii specificaţi semn de omisiune nelegat de lăţime şi înălţime, în unităţile logice; exactă lăţimea şi înălţimea, în pixeli, depinde de modul de mapare a ferestrei.

CreateCaret automat distruge forma semnul anterioară, dacă este cazul, indiferent de fereastra care deţine semn de omisiune nelegat. Semn de omisiune nelegat este ascunse până când cererea apelează funcţia ShowCaret pentru a face semn de omisiune nelegat vizibile.

Sistemul oferă un semn de omisiune pe coada de aşteptare. O fereastră trebuie crea un semn de omisiune numai atunci când are focalizarea tastaturii sau este activă. Fereastra ar trebui să distrugă semn de omisiune nelegat înainte de a pierde focalizarea tastaturii sau deveni inactiv.

Aveţi posibilitatea să preluaţi lăţime sau înălţime de chenar fereastră a sistemului utilizând funcţia GetSystemMetrics , precizând valorile SM_CXBORDER şi SM_CYBORDER. Chenar fereastră sau înăl?imea garantează că semn de omisiune nelegat vor fi vizibile pe un ecran de înaltă rezoluţie.

Windows CE: Windows CE nu acceptă parametrul hBitmap şi ar trebui stabilite la NULL. Windows CE implicit este un semn de omisiune solide.

QuickInfo

nbsp; Windows &NT: necesită versiunea 3.1 sau mai târziu.
Windows:Necesită Windows 95 sau o versiune ulterioară.
Windows CE:Necesită versiunea 1.0 sau mai târziu.
Antet:A declarat în winuser.h.
Import Biblioteca:Utilizarea user32.lib.

A se vedea, de asemenea

Carets prezentare generală, funcţii semn de omisiune, CreateBitmap, CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index