CreateCaret

CreateCaret işlevi, sistem düzeltme işaretini için yeni bir şekil oluşturur ve belirtilen pencereyi klavyeyle sahipliğini atar. Şapka şekil-ebilmek var olmak bir çizgi, bir blok veya bit eşlem.

bool CreateCaret ()  hwnd  hWnd, / / ele sahip pencereyeHBITMAPhBitmap, / / işlemek için şapka şekil için bit eşlemintnWidth, / / şapka genişliğiintnHeight / / şapka yüksekliği);
 

Parametreleri

hWnd

Şapka sahibi pencereyi tanımlar.

hBitmap

Düzeltme işareti şeklini tanımlayan bit eşlem tanımlar. Bu parametre null ise, şapka katı. Bu parametre (HBITMAP) 1 ise klavyeyle gri olur. Bu parametre bir Biteşlem tutamacı şapka belirtilen bit eşlem ise. Biteşlem tutamacı tarafından oluşturulmuş olması gerekir CreateBitmap, CreateDIBitmap, ya LoadBitmap işlevi.

HBitmap bir Biteşlem tutamacı varsa, CreateCaret nWidth ve nHeight parametreleri yok sayar; bite?lemi kendi genişliği ve yüksekliği tanımlar.

nWidth

Şapka genişliğini mantıksal birimler cinsinden belirtir. Bu parametreyi sıfır ise, sistem tanımlı pencere kenarlık genişliği genişliğe ayarlanır. CreateCaret hBitmap bir Biteşlem tutamacı varsa, bu parametre dikkate almaz.

nHeight

Şapka mantıksal birimler cinsinden yüksekliğini belirtir. Bu parametreyi sıfır ise, sistem tanımlı pencere kenarlık yüksekliği ayarlayın. CreateCaret hBitmap bir Biteşlem tutamacı varsa, bu parametre dikkate almaz.

Dönüş değerleri

İşlev başarılı olursa, dönüş değeri sıfır.

İşlev başarısız olursa, dönüş değeri sıfırdır. Genişletilmiş hata bilgilerini için GetLastError.

Açıklamalar

NWidth ve nHeight parametreleri şapka'nın genişliği ve yüksekliği, mantıksal birimler cinsinden belirtin; tam genişlik ve yüksekliği piksel cinsinden pencerenin eşleme moduna bağlıdır.

CreateCaret şapka sahibi pencere bakılmaksızın, varsa önceki düzeltme işareti şekli otomatik olarak yok eder. Uygulama düzeltme işareti görünür hale getirmek için ShowCaret işlevini çağırır kadar çıkıntı işareti gizlenir.

Sistem, sıranın başına bir şapka sağlar. Yalnızca klavye odağını vardır veya etkin pencereyi şapka işareti oluşturmanız gerekir. Pencereyi Klavyeyle klavye odağını kaybediyor veya etkin olma önce yok.

Eğer genişlik veya yükseklik sistemin pencere kenarlık GetSystemMetrics işlevini kullanarak sm_cxborder ve sm_cyborder değerleri belirtme alabilirsiniz. Pencere kenarlık genişliği veya yüksekliği kullanarak şapka yüksek çözünürlüklü ekranda görünür olacağını garanti eder.

Windows ce: Windows ce hBitmap parametresini desteklemez ve null olarak ayarlanmalıdır. Windows ce varsayılan düz şapka işareti.

QuickInfo

nbsp; Windows &NT: sürüm 3.1 veya üstü gerektirir.
Windows:Windows 95 veya sonraki sürümleri gerektirir.
Windows ce:Sürüm 1.0 veya daha ilerisini gerektirir.
Header:WINUSER.h ilan etti.
İçe Library:User32.lib kullanma.

Ayrıca bkz:

Belirliyorsanız düzeltme işaretleri genel bakış, şapka işlevleri, CreateBitmap, CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index