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