CreateCaret

Funkcja CreateCaret tworzy nowego kształtu z karetki systemowej i przypisuje własności daszek określonego okna. Kształt daszek może być linią, bloku lub bitmapę.

(BOOL CreateCaret HWND  hWnd, / / dojście do okna właścicielaHBITMAPhBitmap, / / dojście do mapy bitowej daszek kształtuintnWidth właściwości, / / szerokość daszkaintnHeight / / wysokość daszka);
 

Parametry

hWnd

Identyfikuje okno, w którym jest właścicielem daszek.

hBitmap

Identyfikuje mapy bitowej, który definiuje kształt daszek. Jeśli ten parametr ma wartość NULL, daszek jest pełny. Jeśli ten parametr jest (HBITMAP) 1, daszek jest szary. Jeśli ten parametr ma uchwyt bitmapy, daszek jest podana mapa bitowa. Uchwyt bitmapy, musi być utworzony przez CreateBitmap, CreateDIBitmap, lub LoadBitmap funkcji.

Jeśli hBitmap jest uchwyt bitmapy, CreateCaret ignoruje parametry nWidth właściwości i nHeight ; bitmapy definiuje własne szerokość i wysokość.

nWidth właściwości

Określa szerokość daszek jednostek logicznych. Jeśli ten parametr jest równy zero, szerokość jest równa szerokości obramowania okna zdefiniowanych w systemie. Jeśli hBitmap jest uchwyt bitmapy, CreateCaret zignoruje ten parametr.

nHeight

Określa wysokość, logiczne jednostki karetka. Jeśli ten parametr jest równy zero, wysokość jest ustawiona na wysokość obramowanie okna zdefiniowanych w systemie. Jeśli hBitmap jest uchwyt bitmapy, CreateCaret zignoruje ten parametr.

Zwraca wartości

Jeśli funkcja, wartość zwracany jest różna od zera.

Jeśli funkcja zawiedzie, wartość zwracany jest równa zero. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Parametry nWidth właściwości i nHeight określają szerokość i wysokość, daszek jednostkach logicznych; dokładną szerokość i wysokość w pikselach, zależy od trybu mapowania okna.

CreateCaret automatycznie niszczy poprzedniego kształtu znaku karetki, jeżeli taka istnieje, niezależnie od tego okna, który jest właścicielem daszek. Daszek jest ukryte, dopóki aplikacja wywołuje funkcję ShowCaret , aby wyświetlić daszek.

System zapewnia jeden daszek na kolejkę. Okno należy tworzyć daszek, tylko wtedy, gdy nie ma fokusu klawiatury lub jest aktywny. Okno należy zniszczyć daszek przed utracie fokusu klawiatury lub staje się nieaktywna.

Można pobrać szerokość lub wysokość obramowanie okna systemu za pomocą funkcji GetSystemMetrics , określając wartości SM_CXBORDER i SM_CYBORDER. Przy użyciu okna obramowania szerokość lub wysokość gwarantuje, że daszek będą widoczne na ekranach o wysokiej rozdzielczości.

Systemu Windows CE: Windows CE nie obsługuje parametrów hBitmap i powinna być ustawiona na wartość NULL. Domyślnie system Windows CE daszek stałe.

Skrócone informacje

nbsp; Windows &NT: wymagana wersja 3.1 lub nowsza.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Wymaga wersja 1.0 lub nowsza.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Daszka omówienie, funkcje daszka, CreateBitmap, CreateDIBitmap, DestroyCaret, GetSystemMetrics, HideCaret, LoadBitmap, ShowCaret

Index