Picture Property (ButtonCellType)

Visual Basic
C#

'Declaration
 
Public Property Picture As Image

'Usage
 
Dim instance As ButtonCellType
Dim value As Image
 
instance.Picture = value
 
value = instance.Picture

public Image Picture {get; set;}

Property Value

Image object containing the picture for the button

If you set the TwoState property to true, you can set a different image for each of the two states of the button. Use this property to set the image for the button when it is not pressed. Use the PictureDown property to set the image for the button when it is pressed.

Tip: When using custom images to represent states, try to create a consistent look and feel. Also, be aware of common interface conventions used to represent states.

This example sets up a cell in the first sheet as a two-state button cell (so each time the user clicks on it, it toggles) with the Picture image displayed in one state and PictureDown image displayed in the other state. The text is displayed above the image in the button.

C#

FarPoint.Win.Spread.CellType.ButtonCellType butncell = new FarPoint.Win.Spread.CellType.ButtonCellType();
butncell.TwoState = true;
Image upimage;
Image dnimage;
upimage = Image.FromFile("..\\images\\up.jpg");
dnimage = Image.FromFile("..\\images\\down.jpg");
butncell.Picture = upimage;
butncell.PictureDown = dnimage;
butncell.TextAlign = FarPoint.Win.ButtonTextAlign.TextTopPictBottom;
butncell.Text = "Now up - Click";
butncell.TextDown ="Now down - Click";
fpSpread1.Sheets[0].Cells[4,2].CellType = butncell;

Visual Basic

Dim butncell As New FarPoint.Win.Spread.CellType.ButtonCellType()
butncell.TwoState = True
Dim upimage As Image
Dim dnimage As Image
butncell.Picture = upimage.FromFile("..\images\up.jpg")
butncell.PictureDown = dnimage.FromFile("..\images\down.jpg")
butncell.TextAlign = FarPoint.Win.ButtonTextAlign.TextTopPictBottom
butncell.Text = "Now up - Click"
butncell.TextDown ="Now down - Click"
fpSpread1.Sheets(0).Cells(4,2).CellType = butncell

Target Platforms: Windows 2000 Professional (SP4), Windows 2000 Server, Windows 2003 Server (SP1), Windows 2008, Windows XP (SP2), Windows Vista, Windows 7, Windows 8

Reference

ButtonCellType Class
ButtonCellType Members
PictureDown Property
TwoState Property