LoadCursor

Funkcja LoadCursor ładuje zasobu określonego kursora z pliku wykonywalnego (.Plik EXE) skojarzone z wystąpieniem aplikacji.

Funkcja ta została zastąpiona funkcji LoadImage

(HCURSOR LoadCursor Wystąpienie HINSTANCE  wystąpienie hInstance, / / dojście do instancji aplikacjiLPCTSTRlpCursorName / / nazwa identyfikator zasobu ciągu lub kursora);
 

Parametry

wystąpienie hInstance
Dojście do wystąpienia modułu, którego plik wykonywalny zawiera kursor do załadowania.
lpCursorName
Wskaźnik ciąg zakończony znakiem null, który zawiera nazwę zasobu kursor do załadowania. Alternatywnie ten parametr może zawierać identyfikator zasobu w programie word bity i zera w programie word wysokich numerach. Makro MAKEINTRESOURCE może także służyć do tworzenia tej wartości.

Któregoś z kursorów Win32 wstępnie zdefiniowane, aplikacja musi ustawić wystąpienie hInstance parametr NULL i parametru lpCursorName do jednego następujące wartości:
Wartość Opis
IDC_APPSTARTING Standardowy strzałkę i małych Klepsydra
IDC_ARROW Standardowy strzałki
IDC_CROSS Krzyżyk
IDC_HAND Systemu Windows NT 5.0 i nowsze: Ręka
IDC_HELP Strzałki i znak zapytania
IDC_IBEAM Przesuwaj
IDC_ICON Przestarzałe dla aplikacji oznaczone jako wersja 4.0 lub nowszym.
IDC_NO Okrąg przekreślone
IDC_SIZE Przestarzałe dla aplikacji oznaczone jako wersja 4.0 lub nowszej. Użycie IDC_SIZEALL.
IDC_SIZEALL Czterema grotami wskazuje północ, południe, wschód i zachód
IDC_SIZENESW Strzałki dwukierunkowej, wskazując północny wschód i południowy zachód
IDC_SIZENS Strzałki dwukierunkowej, wskazując północ i południe
IDC_SIZENWSE Strzałki dwukierunkowej, wskazując północny zachód i południowo-wschodniej
IDC_SIZEWE Strzałki dwukierunkowej, wskazując Wschodnie i zachodnie
IDC_UPARROW Pionową strzałkę
IDC_WAIT Klepsydra

Zwraca wartości

Jeśli funkcja powiedzie się, wartość zwracany jest dojściem do nowo załadowanym kursorem.

Jeśli funkcja zawiedzie, wartość zwracana jest wartość NULL. Aby uzyskać rozszerzonych informacji o błędach, należy wywołać GetLastError.

Uwagi

Funkcja LoadCursor obciążenia zasobów kursora tylko wtedy, gdy go nie została załadowana; w przeciwnym razie pobiera dojścia do istniejących zasobów. Ta funkcja zwraca uchwyt ważne kursora tylko wtedy gdy punkty parametru lpCursorName do zasobu kursora. Jeśli lpCursorName wskazuje dowolnego typu zasobów innych niż kursor (takie jak ikona), wartość zwracany jest NULL, mimo że nie jest on uchwyt ważne kursora.

Funkcja LoadCursor przeszukuje najbardziej odpowiednie dla kursor dla bieżącego urządzenia wyświetlającego zasobów kursora. Zasób kursor może być mapą bitową kolorów lub monochromatyczne.

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 (IDC_WAIT). Użyj funkcji LoadCursor w połączeniu z funkcją SetCursor , aby 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 obsługuje funkcję LoadCursor tego samego systemu Windows sposób pulpitu platform zrobić, z tym wyjątkiem, że obsługuje tylko kursory monochromatycznych. Windows CE nie obsługuje kolor kursory. Próba załadowania kursor kolor będzie przynieść nieprzewidywalne rezultaty.

Zobacz też

Kursory omówienie, funkcje kursora, LoadImage, MAKEINTRESOURCE, SetCursor, SetCursorPos, ShowCursor

Index