IconExtensions.ExtractNearestBitmap Method

KGy SOFT Drawing Libraries

IconExtensionsExtractNearestBitmap Method KGy SOFT Drawing Libraries Help
Extracts the nearest image of specified size and pixel format from an Icon instance.

Namespace: KGySoft.Drawing
Assembly: KGySoft.Drawing (in KGySoft.Drawing.dll) Version: 4.6.0
Syntax

public static Bitmap ExtractNearestBitmap(
	this Icon icon,
	Size size,
	PixelFormat pixelFormat,
	bool keepOriginalFormat = false
)
<ExtensionAttribute>
Public Shared Function ExtractNearestBitmap ( 
	icon As Icon,
	size As Size,
	pixelFormat As PixelFormat,
	Optional keepOriginalFormat As Boolean = false
) As Bitmap
public:
[ExtensionAttribute]
static Bitmap^ ExtractNearestBitmap(
	Icon^ icon, 
	Size size, 
	PixelFormat pixelFormat, 
	bool keepOriginalFormat = false
)
[<ExtensionAttribute>]
static member ExtractNearestBitmap : 
        icon : Icon * 
        size : Size * 
        pixelFormat : PixelFormat * 
        ?keepOriginalFormat : bool 
(* Defaults:
        let _keepOriginalFormat = defaultArg keepOriginalFormat false
*)
-> Bitmap 

Parameters

icon
Type: System.DrawingIcon
The icon that may contain multiple images.
size
Type: System.DrawingSize
The required icon size to retrieve.
pixelFormat
Type: System.Drawing.ImagingPixelFormat
The required pixel format to retrieve
keepOriginalFormat (Optional)
Type: SystemBoolean
If , keeps the original image format stored in the icon. Possible transparent pixels of non-32 bpp ARGB formats may be black. If , always returns 32 bpp images with transparency. This parameter is optional.
Default value: .

Return Value

Type: Bitmap
An Bitmap instance, which was extracted from the icon. If no icon was found with the specified size and format the nearest image (pixelFormat matches first, then size) is returned.

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).
See Also

Reference