CopyImage

Funkcja CopyImage tworzy nowy obraz (ikona, kursor lub bitmapy) i kopiuje atrybuty określonego obrazu na nowy. Jeśli to konieczne, funkcja rozciąga się bity do żądanego rozmiaru nowego obrazu.

( CopyImage uchwyt UCHWYT  hImage, / / dojście do obrazu do kopiowaniaUINTuType, / / typ obrazu do kopiowaniaintcxDesired, / / pożądane szerokość nowego obrazuintcyDesired, / / pożądane wysokość nowego obrazuUINTfuFlags / / copy flagi);
 

Parametry

hinst
Dojście do instancji modułu, który zawiera obraz do skopiowania.
uType
Określa typ obrazu do skopiowania. Ten parametr może mieć jedną z następujących wartości:
Wartość Znaczenie
IMAGE_BITMAP Skopiowanie bitmapy.
IMAGE_CURSOR Kopiuje kursor.
IMAGE_ICON Kopiuje ikona.

cxDesired
Określa pożądaną szerokość w pikselach, obraz.
cyDesired
Określa odpowiednią wysokość w pikselach, obraz.
fuFlags
Określa kombinację wartości następujących:
Wartość Znaczenie
LR_COPYDELETEORG Usuwa oryginalnego obrazu po utworzeniu kopii.
LR_COPYRETURNORG Tworzy dokładną kopię obrazu, ignorując parametry cxDesired i cyDesired.
LR_MONOCHROME Tworzy nowy obraz monochromatyczny.
LR_COPYFROMRESOURCE Próbuje ponownie załadować ikonę lub kursora zasobu z oryginalnego pliku zasobu, zamiast po prostu kopiowanie bieżącego obrazu. Jest to przydatne do tworzenia kopię różnych rozmiarach, gdy plik zasobów zawiera rozmiary wielu zasobów. Bez tej flagi CopyImage rozciąga obraz oryginalny do nowego rozmiaru. Jeśli ta flaga będzie ustawiona, CopyImage używa rozmiar najbardziej zbliżony do żądanego rozmiaru pliku zasobów.

To powiedzie się tylko wtedy, gdy hImage został załadowany przez LoadIcon lub LoadCursor, lub LoadImage z flagą LR_SHARED.


Zwraca wartości

Jeśli funkcja, wartość zwracany jest dojściem do nowo utworzonego obrazu.

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

Uwagi

Po zakończeniu przy użyciu zasobu można zwolnić jego skojarzony pamięci, wywołując jedną z funkcji w poniższej tabeli.

Zasób Funkcja wydania
Mapa bitowa UsuńObiekt
Kursor DestroyCursor
Ikona DestroyIcon

System automatycznie usuwa zasobu, gdy jego proces zakończy się, jednakże wywołanie odpowiedniej funkcji Oszczędza pamięć i zmniejsza rozmiar zestawu roboczego procesu.

Skrócone informacje

nbsp; Windows &NT: wymaga wersji 3.5 lub nowszej.
Systemu Windows:Wymaga systemu Windows 95 lub nowszego.
Systemu Windows CE:Nieobsługiwane.
Nagłówka:Zadeklarowane w pliku winuser.h.
Importowanie biblioteki:Użycie user32.lib.

Zobacz też

Przegląd zasobów, funkcji zasobów, LoadImage

Index