IconExtensionsExtractIcon(Icon, Size, PixelFormat, Boolean) Method

Extracts the icon of specified size and pixel format from an Icon instance. Unless the Icon constructors, this method works as expected.

Definition

Namespace: KGySoft.Drawing
Assembly: KGySoft.Drawing (in KGySoft.Drawing.dll) Version: 10.0.0-rc.1

C#

public static Icon? ExtractIcon(
	this Icon icon,
	Size size,
	PixelFormat pixelFormat,
	bool forceUncompressedResult
)

VB

<ExtensionAttribute>
Public Shared Function ExtractIcon ( 
	icon As Icon,
	size As Size,
	pixelFormat As PixelFormat,
	forceUncompressedResult As Boolean
) As Icon

C++

public:
[ExtensionAttribute]
static Icon^ ExtractIcon(
	Icon^ icon, 
	Size size, 
	PixelFormat pixelFormat, 
	bool forceUncompressedResult
)

F#

[<ExtensionAttribute>]
static member ExtractIcon : 
        icon : Icon * 
        size : Size * 
        pixelFormat : PixelFormat * 
        forceUncompressedResult : bool -> Icon

Parameters

icon Icon: The icon that may contain multiple images.
size Size: The required icon size to retrieve.
pixelFormat PixelFormat: The required pixel format to retrieve
forceUncompressedResult Boolean: to force returning an uncompressed icon; to allow PNG compression, which is supported by Windows Vista and above.

Return Value

Icon
An Icon instance, which contains only a single image, or if no icon found with the specified size and format.

Usage Note

In Visual Basic and C#, you can call this method as an instance method on any object of type Icon. When you use instance method syntax to call this method, omit the first parameter. For more information, see Extension Methods (Visual Basic) or Extension Methods (C# Programming Guide).

Remarks

Note

On some platforms this method may throw a PlatformNotSupportedException for very large or compressed icons.