NamedRange.Resize Property

Article
07/25/2011

Gets a resized Microsoft.Office.Interop.Excel.Range based on the NamedRange control.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
ReadOnly Property Resize As NamedRange_ResizeType
    Get

NamedRange_ResizeType Resize { get; }

Property Value

Type: Microsoft.Office.Tools.Excel.NamedRange_ResizeType
A resized Microsoft.Office.Interop.Excel.Range based on the NamedRange control.

Remarks

The Resize property is intended to be used with the following parameters.

Parameter	Description
RowSize	The number of rows in the new range. If this argument is omitted, the number of rows in the range remains the same.
ColumnSize	The number of columns in the new range. If this argument is omitted, the number of columns in the range remains the same.

If you attempt to use Resize without specifying any parameters, Resize will get a NamedRange_ResizeType object that is part of the Visual Studio infrastructure and is not intended to be used directly from your code.

Optional Parameters

For information on optional parameters, see Optional Parameters in Office Solutions.

Examples

The following code example creates a NamedRange and then uses the Resize property to get a larger range based on the NamedRange. The code then selects the new range.

This version is for a document-level customization.

    Private resizeRange As Microsoft.Office.Tools.Excel.NamedRange

    Private Sub CreateResizedRange()
        resizeRange = Me.Controls.AddNamedRange( _
            Me.Range("B2", "C4"), "resizeRange")
        Dim range1 As Excel.Range = Me.resizeRange.Resize(6, 6)
        range1.Select()
    End Sub

Microsoft.Office.Tools.Excel.NamedRange resizeRange;
private void CreateResizedRange()
{
    resizeRange = this.Controls.AddNamedRange(
        this.Range["B2", "C4"], "resizeRange");
    Excel.Range range1 = this.resizeRange.Resize[6, 6];
    range1.Select();
}

This version is for an application-level add-in.

Private resizeRange As NamedRange

Private Sub CreateResizedRange()

    Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
        Globals.ThisAddIn.Application.ActiveSheet

    Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
            Globals.Factory.GetVstoObject(NativeWorksheet)

    resizeRange = vstoWorksheet.Controls.AddNamedRange( _
        vstoWorksheet.Range("B2", "C4"), "resizeRange")
    Dim range1 As Excel.Range = resizeRange.Resize(6, 6)
    range1.Select()
End Sub

NamedRange resizeRange;
private void CreateResizedRange()
{
    Worksheet vstoWorksheet =
        Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]);
    resizeRange = vstoWorksheet.Controls.AddNamedRange(
        vstoWorksheet.Range["B2", "C4"], "resizeRange");
    Excel.Range range1 = resizeRange.Resize[6, 6];
    range1.Select();
}

.NET Framework Security

Full trust for the immediate caller. This member cannot be used by partially trusted code. For more information, see Using Libraries from Partially Trusted Code.

Share via