Share via


NamedRange.Resize Property

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

See Also

Reference

NamedRange Interface

Microsoft.Office.Tools.Excel Namespace