CommandBarButtonClass.Mask Property

Reference

Definition

Namespace:: Microsoft.Office.Core

Assembly:: office.dll

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 or sets an IPictureDisp object representing the mask image of a CommandBarButton object. The mask image determines what parts of the button image are transparent. Read/write.

public:
 virtual property stdole::IPictureDisp ^ Mask { stdole::IPictureDisp ^ get(); void set(stdole::IPictureDisp ^ value); };

public virtual stdole.IPictureDisp Mask { get; set; }

member this.Mask : stdole.IPictureDisp with get, set

Public Overridable Property Mask As IPictureDisp

Property Value

IPictureDisp

Implements

Mask

Examples

The following example sets the image and mask of the first CommandBarButton that the code returns. To make this work, create a mask image and a button image and sustitute the paths in the sample with the paths to your images.

The following example gets the image and mask of the first CommandBarButton that the code returns and outputs each of them to a file. To make this work, specify a path for the output files.

Remarks

When you create an image that you plan on using as a mask image, all of the areas that you want to be transparent should be white, and all of the areas that you want to show should be black.

Always set the mask after you have set the picture for a CommandBarButton object.

Applies to