//C
BOOL DestroyIcon(
HICON hIcon
);
//Delphi
function DestroyIcon(hIcon: DWORD): BOOL;
Funkcja DestroyIcon niszczy ikonę i zwalnia pamięć przez nią zajmowaną.
Parametry
hIcon
Uchwyt ikony do zniszczenia. Ikona nie może być w użyciu.
Wartość zwracana
Jeśli funkcja się powiedzie, zwraca wartość różną od zera (True).
Jeśli funkcja się nie powiedzie, zwraca wartość 0 (False). Dodatkowe informacje o błędzie można uzyskać za pomocą funkcji GetLastError.
Uwagi
Wywoływanie funkcji
DestroyIcon jest konieczne tylko dla ikon i kursorów utworzonych przez następujące funkcje: [[WinAPI/CreateIconFromResourceEx]] (jeśli w wywołaniu nie wystąpiła flaga `LR_SHARED`), [[WinAPI/CreateIconIndirect]] oraz [[WinAPI/CopyIcon]]. Nie należy używać tej funkcji do niszczenia współdzielonej ikony. Współdzielona ikona istnieje tak długo jak długo pozostaje w pamięci moduł, z którego została załadowana. Następujące funkcje pobierają współdzielone ikony:
* [[WinAPI/LoadIcon]]
* [[WinAPI/LoadImage]] (jeśli w wywołaniu wystąpi flaga `LR_SHARED`)
* [[WinAPI/CopyImage]] (jeśli w wywołaniu wystąpi flaga `LR_COPYRETURNORG` oraz parametr
hImage wskazuje na współdzieloną ikonę)
* [[WinAPI/CreateIconFromResource]]
* `CreateIconFromResourceEx` (jeśli w wywołaniu wystąpi flaga `LR_SHARED`)
Zobacz też
* [[WinAPI/CopyIcon]]
* [[WinAPI/CreateIconFromResource]]
* [[WinAPI/CreateIconFromResourceEx]]
* [[WinAPI/CreateIconIndirect]]