SetCursor

Składnia

Argumenty

Argument	Opis
HCURSOR hCursor	Uchwyt do kursora, jaki ma zostać ustawiony. Kursor musi zostać utworzony za pomocą funkcji CreateCursor lub załadowany poprzez funkcję LoadCursor bądź LoadImage. Jeżeli wartość tego argumentu będzie wynosiła NULL to kursor zostanie usunięty z ekranu.

Zwracana wartość

Zwraca uchwyt HCURSOR wskazujący na poprzedni kursor jeżeli był wcześniej jakiś ustawiony. Jeżeli nie było poprzedniego kursora funkcja zwraca wartość NULL.

Opis szczegółowy

Funkcja ustawia nowy wygląd kursora myszy. Nowy kursor jest ustawiany tylko wtedy gdy nowy kursor jest inny od obecnie używanego. Jeżeli kursory są takie same to żadna akcja nie jest podejmowana, a uchwyt kursora jest natychmiastowo zwracany.

Kursor jest współdzielonym zasobem. Okno powinno ustawiać kształt kursora tylko gdy kursor jest w obszarze roboczym okna lub gdy okno przechwytuje wejście myszy. W systemach bez myszy okno powinno przywracać poprzedni kursor zanim kursor opuści obszar roboczy klienta lub zanim kontrola nad myszą zostanie przekazana do innego okna.

Jeżeli Twoja aplikacja musi ustawiać kursor myszy to upewnij się, że kursor dla określonego okna jest ustawiony na wartość NULL. Jeżeli uchwyt kursora posiada wartość różną od NULL to system przywraca wygląd kursora za każdym razem gdy mysz zostanie poruszona.

Kursor myszy nie jest wyświetlany na ekranie jeżeli wewnętrzny licznik wyświetlania myszy jest mniejszy niż zero. Taka sytuacja zachodzi gdy aplikacja używa funkcji ShowCursor do ukrywania kursora większej liczby razy niż do akcji pokazywania kursora.

Linki zewnętrzne

• http://msdn.microsoft.com/en-us/library/windows/desktop/ms648393(v=vs.85).aspx