FillRange(Int32,Int32,Int32,Int32,Int32,FillDirection,Boolean,Boolean) Method

Fills a range of cells on this sheet by copying a specified range in the specified direction.

Syntax

Visual Basic
C#

'Declaration
 
Public Overloads Sub FillRange( _
   ByVal row As Integer, _
   ByVal column As Integer, _
   ByVal rowCount As Integer, _
   ByVal columnCount As Integer, _
   ByVal fillCount As Integer, _
   ByVal fillDirection As FillDirection, _
   ByVal dataOnly As Boolean, _
   ByVal valuesOnly As Boolean _
)

'Usage
 
Dim instance As SheetView
Dim row As Integer
Dim column As Integer
Dim rowCount As Integer
Dim columnCount As Integer
Dim fillCount As Integer
Dim fillDirection As FillDirection
Dim dataOnly As Boolean
Dim valuesOnly As Boolean
 
instance.FillRange(row, column, rowCount, columnCount, fillCount, fillDirection, dataOnly, valuesOnly)

public void FillRange( 
   int row,
   int column,
   int rowCount,
   int columnCount,
   int fillCount,
   FillDirection fillDirection,
   bool dataOnly,
   bool valuesOnly
)

Parameters

row: Row index of the starting cell in the range to copy
column: Column index of the starting cell in the range to copy
rowCount: Number of rows in the range to copy
columnCount: Number of columns in the range to copy
fillCount: Number of rows or columns into which to copy the specified range
fillDirection: Direction of fill (to copy the specified range)
dataOnly: Whether to fill data only (or also styles and spans)
valuesOnly: Whether to fill in values only (or also formulas, notes, and tags)

Exceptions

Exception	Description
System.ArgumentOutOfRangeException	Specified row index is not valid; must be between -1 and the total number of rows
System.ArgumentOutOfRangeException	Specified column index is not valid; must be between -1 and the total number of columns
System.ArgumentOutOfRangeException	Specified row count is not valid; must be -1 or between 0 and the total number of rows minus the current row index
System.ArgumentOutOfRangeException	Specified column count is not valid; must be -1 or between 0 and the total number of columns minus the current column index
System.ArgumentOutOfRangeException	Specified number of rows or columns (fill count) is not valid; must be -1 or between 0 and the total number of rows or columns
System.ComponentModel.InvalidEnumArgumentException	Specified direction of the fill is not valid; must be one of the allowed enumeration settings
System.InvalidOperationException	Specified target range contains one or more cell spans so the operation cannot be completed.

Example

This example uses the FillRange method.

//  Define the text to repeat.
fpSpread1.ActiveSheet.Cells[0, 0].Text = "A1-text";
fpSpread1.ActiveSheet.Cells[0, 1].Text = "A2-text";
fpSpread1.ActiveSheet.Cells[1, 0].Text = "B1-text";
fpSpread1.ActiveSheet.Cells[1, 1].Text = "B2-text";
fpSpread1.ActiveSheet.Cells[0, 0].BackColor = Color.Cyan;
fpSpread1.ActiveSheet.Cells[0, 0].ForeColor = Color.DarkBlue;
fpSpread1.ActiveSheet.Cells[0, 1].BackColor = Color.Coral;
fpSpread1.ActiveSheet.Cells[0, 1].ForeColor = Color.DarkRed;

// Fill three more columns to the right with the two columns' contents.
fpSpread1.ActiveSheet.FillRange(0, 1, 2, 1, 3, FarPoint.Win.Spread.FillDirection.Right, true, false);

Visual Basic

'  Define the text to repeat.
FpSpread1.ActiveSheet.Cells(0, 0).Text = "A1-text"
FpSpread1.ActiveSheet.Cells(0, 1).Text = "A2-text"
FpSpread1.ActiveSheet.Cells(1, 0).Text = "B1-text"
FpSpread1.ActiveSheet.Cells(1, 1).Text = "B2-text"
FpSpread1.ActiveSheet.Cells(0, 0).BackColor = Color.Cyan
FpSpread1.ActiveSheet.Cells(0, 0).ForeColor = Color.DarkBlue
FpSpread1.ActiveSheet.Cells(0, 1).BackColor = Color.Coral
FpSpread1.ActiveSheet.Cells(0, 1).ForeColor = Color.DarkRed

' Fill three more columns to the right with the two columns' contents.
FpSpread1.ActiveSheet.FillRange(0, 1, 2, 1, 3, FarPoint.Win.Spread.FillDirection.Right, True, False)

Requirements

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

Reference

SheetView Class
SheetView Members
Overload List