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