Hide Table of Contents
SetBitmapsByName3 Method (IPropertyManagerPageBitmapButton)

Inserts the specified image for this button.

.NET Syntax

Visual Basic (Declaration) 
Function SetBitmapsByName3( _
   ByVal ImageList As System.Object, _
   ByVal MaskImageList As System.Object _
) As System.Boolean
Visual Basic (Usage) 
Dim instance As IPropertyManagerPageBitmapButton
Dim ImageList As System.Object
Dim MaskImageList As System.Object
Dim value As System.Boolean
 
value = instance.SetBitmapsByName3(ImageList, MaskImageList)
C# 
System.bool SetBitmapsByName3( 
   System.object ImageList,
   System.object MaskImageList
)
C++/CLI 
System.bool SetBitmapsByName3( 
&   System.Object^ ImageList,
&   System.Object^ MaskImageList
) 

Parameters

ImageList
Array of strings for the paths for the image files for the button in its non-selected state (see Remarks)
MaskImageList
Array of strings for the paths for the image files for the image masks (see Remarks)

Return Value

True if the image is inserted, false if not

Example

Remarks

This method supports scaling for high resolution screens with high resolution operating system scaling options. 

ImageList and MaskImageList images can be:

  • 20 x 20 pixels
  • 32 x 32 pixels
  • 40 x 40 pixels
  • 64 x 64 pixels
  • 96 x 96 pixels
  • 128 x128 pixels 

Images should use:

  • 256-color palette.
  • margin of at least 3 blank pixels on all sides of the image because this is where the button borders are drawn; i.e., any pixels in the image in these 3 outer rows and columns of pixels are obscured by the button borders.

You can specify your own image masks using the MaskImageList argument, which should display the images exactly as you created them. If you specify an empty array for MaskImageList, then SOLIDWORKS generates what it needs; however, the images might appear blurred.

The order in which you specify the image files must be the same for ImageList and MaskImageList. For example, if you specify an array of paths to 20 x 20 pixels, 32 x 32 pixels, and 40 x 40 pixels images for ImageList, then you must specify an array of paths to 20 x 20 pixels, 32 x 32 pixels, and 40 x 40 pixels images for MaskImageList.

NOTES:

  • The rest of the images (selected, highlight regular, highlight selected, and disabled) for this button are automatically generated by SOLIDWORKS. 
  • Portable Network Graphics images (.png) do not support masking. To use this method with .png files, pass an array of .png file names to ImageList and a blank string for each item in MaskImageList that corresponds to an item in ImageList.

You must call this method after calling either of the following methods to create the bitmap button control:

 

See Also

Availability

SOLIDWORKS 2016 FCS, Revision Number 24.0


Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   SetBitmapsByName3 Method (IPropertyManagerPageBitmapButton)
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:

x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2019 SP05

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.