ToolboxBitmapAttribute.GetImage Method

Reference

Definition

Namespace:: System.Drawing

Assembly:: System.Drawing.Common.dll

Assembly:: System.Drawing.dll

Package:: System.Drawing.Common v8.0.10

Package:: System.Drawing.Common v9.0.0-rc.2.24474.1

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets the small or large Image associated with this ToolboxBitmapAttribute object.

Overloads

GetImage(Object)	Gets the small Image associated with this ToolboxBitmapAttribute object.
GetImage(Type)	Gets the small Image associated with this ToolboxBitmapAttribute object.
GetImage(Object, Boolean)	Gets the small or large Image associated with this ToolboxBitmapAttribute object.
GetImage(Type, Boolean)	Gets the small or large Image associated with this ToolboxBitmapAttribute object.
GetImage(Type, String, Boolean)	Gets the small or large Image associated with this ToolboxBitmapAttribute object.

GetImage(Object)

Source:: ToolboxBitmapAttribute.cs

Source:: ToolboxBitmapAttribute.cs

Gets the small Image associated with this ToolboxBitmapAttribute object.

public:
 System::Drawing::Image ^ GetImage(System::Object ^ component);

public System.Drawing.Image? GetImage (object? component);

public System.Drawing.Image GetImage (object component);

member this.GetImage : obj -> System.Drawing.Image

Public Function GetImage (component As Object) As Image

Parameters

component: Object

If this ToolboxBitmapAttribute object does not already have a small image, this method searches for a bitmap resource in the assembly that defines the type of the object specified by the component parameter. For example, if you pass an object of type ControlA to the component parameter, then this method searches the assembly that defines ControlA.

Returns

Image

The small Image associated with this ToolboxBitmapAttribute object.

Examples

The following example demonstrates how to use the GetImage method.

private:
    static Image^ GetImageOfCustomControl(Control^ userControl)
    {
        Image^ controlImage = nullptr;
        AttributeCollection^ attrCol =
            TypeDescriptor::GetAttributes(userControl);
        ToolboxBitmapAttribute^ imageAttr = (ToolboxBitmapAttribute^)
            attrCol[ToolboxBitmapAttribute::typeid];
        if (imageAttr != nullptr)
        {
            controlImage = imageAttr->GetImage(userControl);
        }

        return controlImage;
    }

private Image GetImageOfCustomControl(Control userControl)
{
    Image controlImage = null;
    AttributeCollection attrCol = 
            TypeDescriptor.GetAttributes(userControl);
    ToolboxBitmapAttribute imageAttr = (ToolboxBitmapAttribute)
        attrCol[typeof(ToolboxBitmapAttribute)];
    if (imageAttr != null)
    {
        controlImage = imageAttr.GetImage(userControl);
    }

    return controlImage;
}

Private Function GetImageOfCustomControl(ByVal userControl As Control) As Image 
    Dim controlImage As Image = Nothing
    Dim attrCol As AttributeCollection = TypeDescriptor.GetAttributes(userControl)
    Dim imageAttr As ToolboxBitmapAttribute = _
        CType(attrCol(GetType(ToolboxBitmapAttribute)), ToolboxBitmapAttribute)
    If (imageAttr IsNot Nothing) Then
        controlImage = imageAttr.GetImage(userControl)
    End If
    
    Return controlImage

End Function

Remarks

This method searches for a resource named namespace.classname.bmp, where namespace is the namespace containing the definition of the type of the object specified by the component parameter. For example, suppose you pass an object of type ControlA to the component parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.ControlA.bmp.

Applies to

GetImage(Type)

Source:: ToolboxBitmapAttribute.cs

Source:: ToolboxBitmapAttribute.cs

Gets the small Image associated with this ToolboxBitmapAttribute object.

public:
 System::Drawing::Image ^ GetImage(Type ^ type);

public System.Drawing.Image? GetImage (Type type);

public System.Drawing.Image GetImage (Type type);

member this.GetImage : Type -> System.Drawing.Image

Public Function GetImage (type As Type) As Image

Parameters

type: Type

If this ToolboxBitmapAttribute object does not already have a small image, this method searches for a bitmap resource in the assembly that defines the type specified by the type parameter. For example, if you pass typeof(ControlA) to the type parameter, then this method searches the assembly that defines ControlA.

Returns

Image

The small Image associated with this ToolboxBitmapAttribute object.

Remarks

This method searches for a resource named namespace.classname.bmp, where namespace is the namespace containing the definition of the type specified by the type parameter. For example, suppose you pass typeof(ControlA) to the type parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.ControlA.bmp.

Applies to

GetImage(Object, Boolean)

Source:: ToolboxBitmapAttribute.cs

Source:: ToolboxBitmapAttribute.cs

Gets the small or large Image associated with this ToolboxBitmapAttribute object.

public:
 System::Drawing::Image ^ GetImage(System::Object ^ component, bool large);

public System.Drawing.Image? GetImage (object? component, bool large);

public System.Drawing.Image GetImage (object component, bool large);

member this.GetImage : obj * bool -> System.Drawing.Image

Public Function GetImage (component As Object, large As Boolean) As Image

Parameters

component: Object

large: Boolean

Specifies whether this method returns a large image (true) or a small image (false). The small image is 16 by 16, and the large image is 32 by 32.

Returns

Image

An Image object associated with this ToolboxBitmapAttribute object.

Remarks

If this ToolboxBitmapAttribute object does not already have a large image, this method creates a large image by scaling the small image.

Applies to

GetImage(Type, Boolean)

Source:: ToolboxBitmapAttribute.cs

Source:: ToolboxBitmapAttribute.cs

Gets the small or large Image associated with this ToolboxBitmapAttribute object.

public:
 System::Drawing::Image ^ GetImage(Type ^ type, bool large);

public System.Drawing.Image? GetImage (Type type, bool large);

public System.Drawing.Image GetImage (Type type, bool large);

member this.GetImage : Type * bool -> System.Drawing.Image

Public Function GetImage (type As Type, large As Boolean) As Image

Parameters

type: Type

If this ToolboxBitmapAttribute object does not already have a small image, this method searches for a bitmap resource in the assembly that defines the type specified by the component type. For example, if you pass typeof(ControlA) to the type parameter, then this method searches the assembly that defines ControlA.

large: Boolean

Specifies whether this method returns a large image (true) or a small image (false). The small image is 16 by 16, and the large image is 32 by 32.

Returns

Image

An Image associated with this ToolboxBitmapAttribute object.

Remarks

This method searches for a resource named namespace.classname.bmp, where namespace is the namespace containing the definition of the type specified by the type parameter. For example, suppose you pass an typeof(ControlA) to the type parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.ControlA.bmp.

If this ToolboxBitmapAttribute object does not already have a large image, this method creates a large image by scaling the small image.

Applies to

GetImage(Type, String, Boolean)

Source:: ToolboxBitmapAttribute.cs

Source:: ToolboxBitmapAttribute.cs

Gets the small or large Image associated with this ToolboxBitmapAttribute object.

public:
 System::Drawing::Image ^ GetImage(Type ^ type, System::String ^ imgName, bool large);

public System.Drawing.Image? GetImage (Type type, string? imgName, bool large);

public System.Drawing.Image GetImage (Type type, string imgName, bool large);

member this.GetImage : Type * string * bool -> System.Drawing.Image

Public Function GetImage (type As Type, imgName As String, large As Boolean) As Image

Parameters

type: Type

If this ToolboxBitmapAttribute object does not already have a small image, this method searches for an embedded bitmap resource in the assembly that defines the type specified by the component type. For example, if you pass typeof(ControlA) to the type parameter, then this method searches the assembly that defines ControlA.

imgName: String

The name of the embedded bitmap resource.

large: Boolean

Specifies whether this method returns a large image (true) or a small image (false). The small image is 16 by 16, and the large image is 32 by 32.

Returns

Image

An Image associated with this ToolboxBitmapAttribute object.

Remarks

This method searches for a resource named namespace.imgName, where namespace is the namespace containing the definition of the type specified by the type parameter. For example, suppose you pass typeof(ControlA) to the type parameter and that you passed "MyBitmap.bmp" to the imgName parameter. If ControlA is in NamespaceA in AssemblyA.dll, then this method searches AssemblyA.dll for a resource named NamespaceA.MyBitmap.bmp.

If this ToolboxBitmapAttribute object does not already have a large image, this method creates a large image by scaling the small image.

Applies to

Share via

ToolboxBitmapAttribute.GetImage Method

Definition

Overloads

GetImage(Object)

Parameters

Returns

Examples

Remarks

Applies to

GetImage(Type)

Parameters

Returns

Remarks

Applies to

GetImage(Object, Boolean)

Parameters

Returns

Remarks

Applies to

GetImage(Type, Boolean)

Parameters

Returns

Remarks

Applies to

GetImage(Type, String, Boolean)

Parameters

Returns

Remarks

Applies to

Additional resources