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.

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