Locked Property (Row)

In This Topic

Gets or sets whether cells in this row are marked as locked.

Syntax

Visual Basic
C#

'Declaration
 
Public Property Locked As Boolean

'Usage
 
Dim instance As Row
Dim value As Boolean
 
instance.Locked = value
 
value = instance.Locked

public bool Locked {get; set;}

Property Value

true if cells are marked as locked; false otherwise

Remarks

You can specify that certain cells are locked; that is, the user cannot edit them. You mark cells as locked using this property. Cells are not locked until the SheetView object's Protect property is set to true for the sheet. Because the Protect property's default value is true, unless you have changed the value of the Protect property, when you mark a cell as locked, it is locked and the user cannot edit it.

Note that when the Protect property is false, the user can still interact with cells marked as locked.

The setting for this property can be overridden if a named style is assigned to the cell using the StyleName property, and that named style sets the locked status.

Example

This example creates a multiple Row object and adjusts the alignment of the text in the row. The width of the second column is changed so that the alignment changes can be easily seen. The contents of the cells in the rows are locked to prevent editing.

FpSpread1.ActiveSheetView.ColumnCount=10;
FpSpread1.ActiveSheetView.PageSize=20;
FpSpread1.ActiveSheetView.RowCount=20;
FarPoint.Web.Spread.Row myrow;
myrow=FpSpread1.ActiveSheetView.Rows[1,3];
myrow.HorizontalAlign=HorizontalAlign.Right;
myrow.VerticalAlign=VerticalAlign.Top;
myrow.Locked=true;
FpSpread1.ActiveSheetView.Columns[1].Width=140;
for(int i=0;i<FpSpread1.ActiveSheetView.RowCount;i++)
{
FpSpread1.ActiveSheetView.SetValue(i,1,"Alignment");
}
TextBox1.Text=Convert.ToString(myrow.Index2);

Visual Basic

FpSpread1.ActiveSheetView.ColumnCount=10
FpSpread1.ActiveSheetView.PageSize=20
FpSpread1.ActiveSheetView.RowCount=20
Dim myrow As FarPoint.Web.Spread.Row
Dim row,row1,i As Integer
row=1
row1=3
myrow=FpSpread1.ActiveSheetView.Rows(row,row1)
myrow.HorizontalAlign=HorizontalAlign.Right
myrow.VerticalAlign=VerticalAlign.Top
myrow.Locked=True
FpSpread1.ActiveSheetView.Columns(1).Width=140
For i=0 To FpSpread1.ActiveSheetView.RowCount-1
FpSpread1.ActiveSheetView.SetValue(i,1,"Alignment")
Next i

Reference

Row Class
Row Members
Protect Property

User-Task Documentation

Locking a Cell

Product Support Forum | Print this page