SetCursor

Funkcja SetCursor ustanawia kształt kursora.

(HCURSOR SetCursor HCURSOR  hCursor / / dojście do kursora);
 

Parametry

hCursor
Dojście do kursora. Kursor musi został stworzony przez CreateCursor lub ładowany przez funkcję LoadCursor lub LoadImage . Jeśli ten parametr ma wartość NULL, kursor jest usuwany z ekranu.

Systemu Windows 95: Szerokość i wysokość kursora musi mieć wartość zwracany przez GetSystemMetrics funkcji SM_CXCURSOR i SM_CYCURSOR. Ponadto głębia bitowa kursor musi odpowiadać głębię koloru ekranu lub kursor musi być monochromatyczny.

Zwraca wartości

Wartość zwracany jest dojście do poprzedniego kursora, jeśli istniał jeden.

Jeśli nie było żadnych poprzednich kursora, wartość zwracana jest wartość NULL.

Uwagi

Kursor jest ustawiony tylko wtedy, gdy nowy kursor różni się od poprzednich kursora; w przeciwnym wypadku funkcja zwraca niezwłocznie.

Kursor jest zasobem udostępnionym. Okno należy ustawić kształt kursora tylko wtedy, gdy kursor znajduje się w swoim obszarze klienta lub gdy okno jest przechwytywanie sygnału wejściowego myszy. W systemach bez użycia myszy okna należy przywrócić poprzednie kursora, zanim kursor opuści obszaru klienckiego lub przed zwalnia kontroli do innego okna.

Jeśli aplikacja musi ustawić kursor, chociaż w oknie, upewnij się, że kursor klasy dla określonego okna klasy jest ustawiona na wartość NULL. Jeśli kursor klasa nie jest równa NULL, systemu przywraca kursor klasy każdym razem, gdy przesuwany jest.

Kursor nie jest wyświetlany na ekranie, jeśli liczba wyświetlanych wewnętrznego kursor jest mniejsza od zera. Dzieje się tak, jeśli aplikacja używa funkcji ShowCursor aby ukryć kursor razy więcej niż aby wyświetlić kursora.

Systemu Windows CE: Podczas ukierunkowanych na platformę, która nie obsługuje kursory myszy, należy użyć składnika kursora. Tylko kursor, który obsługuje ten składnik jest kursor oczekiwania. Użyć następującego kodu ustawić kursor oczekiwania

SetCursor (LoadCursor (NULL, IDC_WAIT));

Użyć składnika mcursor podczas ukierunkowanych na platformie, który obsługuje kursory myszy. Ten składnik nie obsługuje kolor kursory.

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ż

Omówienie kursory, działa Cursor, CreateCursor, GetCursor, GetSystemMetrics, LoadCursor, LoadImage, SetCursorPos, ShowCursor

Index