Item(Int32,Int32,Int32,Int32) Property

Returns a new 2d range instance of IRange which is offset from the top-left cell of the current range by the specified starting and ending row and column offsets.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Overloads ReadOnly Property Item( _
   ByVal row1Offset As System.Integer, _
   ByVal column1Offset As System.Integer, _
   ByVal row2Offset As System.Integer, _
   ByVal column2Offset As System.Integer _
) As IRange

'Usage
 
Dim instance As IRange
Dim row1Offset As System.Integer
Dim column1Offset As System.Integer
Dim row2Offset As System.Integer
Dim column2Offset As System.Integer
Dim value As IRange
 
value = instance.Item(row1Offset, column1Offset, row2Offset, column2Offset)

IRange Item( 
   System.int row1Offset,
   System.int column1Offset,
   System.int row2Offset,
   System.int column2Offset
) {get;}

read-only property Item( 
    row1Offset: System.Integer;
    column1Offset: System.Integer;
    row2Offset: System.Integer;
    column2Offset: System.Integer
): IRange;

function get Item( 
   row1Offset : System.int,
   column1Offset : System.int,
   row2Offset : System.int,
   column2Offset : System.int
) : IRange

__property IRange* get_Item( 
   System.int row1Offset,
   System.int column1Offset,
   System.int row2Offset,
   System.int column2Offset
);

property IRange^ Item {
   IRange^ get(System.int row1Offset, System.int column1Offset, System.int row2Offset, System.int column2Offset);
}

Parameters

row1Offset: The offset for the top row of the new range (may be negative).
column1Offset: The offset for the left column of the new range (may be negative).
row2Offset: The offset for the bottom row of the new range (may be negative).
column2Offset: The offset for the right column of the new range (may be negative).

Example

class Program
{
    static void Main()
    {
        // Create a workbook.
        SpreadsheetGear.IWorkbook workbook = SpreadsheetGear.Factory.GetWorkbook();
        // Get the worksheet and change the name.
        SpreadsheetGear.IWorksheet worksheet = workbook.Worksheets["Sheet1"];
        worksheet.Name = "2005 Sales";
        // Get the worksheet cells reference.
        SpreadsheetGear.IRange cells = worksheet.Cells;
        // Add column headers using a string index into the cell range.
        cells["B1"].Formula = "Jan";
        cells["C1"].Formula = "Feb";
        cells["D1"].Formula = "Mar";
        // Add row headers using zero based row and column indexes.
        cells[1, 0].Formula = "Jennifer";
        cells[2, 0].Formula = "William";
        cells[3, 0].Formula = "Kristen";
        // Add random data using a multiple cell string index.
        cells["B2:D4"].Formula = "=RAND()*10000";
        // Center the column headers using multiple cell row and column indexes.
        cells[0, 1, 0, 3].HorizontalAlignment = SpreadsheetGear.HAlign.Center;
        // Bold the row and column headers using a string index to multiple ranges.
        cells["B1:D1,A2:A4"].Font.Bold = true;
        // Format the data as currency.
        cells["B2:D4"].NumberFormat = "$#,##0";
        // Write the workbook.
        workbook.SaveAs("2005 Sales.xls", SpreadsheetGear.FileFormat.Excel8);
    }
}

Visual Basic

Class Program
    Shared Sub Main()
        ' Create a workbook.
        Dim workbook As SpreadsheetGear.IWorkbook = SpreadsheetGear.Factory.GetWorkbook()
        ' Get the worksheet and change the name.
        Dim worksheet As SpreadsheetGear.IWorksheet = workbook.Worksheets("Sheet1")
        worksheet.Name = "2005 Sales"
        ' Get the worksheet cells reference.
        Dim cells As SpreadsheetGear.IRange = worksheet.Cells
        ' Add column headers using a string index into the cells range.
        cells("B1").Formula = "Jan"
        cells("C1").Formula = "Feb"
        cells("D1").Formula = "Mar"
        ' Add row headers using zero based row and column indexes.
        cells(1, 0).Formula = "Jennifer"
        cells(2, 0).Formula = "William"
        cells(3, 0).Formula = "Kristen"
        ' Add random data using a multiple cell string index.
        cells("B2:D4").Formula = "=RAND()*10000"
        ' Center the column headers using multiple cell row and column indexes.
        cells(0, 1, 0, 3).HorizontalAlignment = SpreadsheetGear.HAlign.Center
        ' Bold the row and column headers using a string index to multiple ranges.
        cells("B1:D1,A2:A4").Font.Bold = True
        ' Format the data as currency.
        cells("B2:D4").NumberFormat = "$#,##0"
        ' Write the workbook.
        workbook.SaveAs("2005 Sales.xls", SpreadsheetGear.FileFormat.Excel8)
    End Sub 'Main
End Class 'Program

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IRange Interface
IRange Members
Overload List
Item(String) Property
Item(Int32,Int32) Property