How to: Resize NamedRange Controls

You can set the size of a NamedRange control when you add it to a Microsoft Office Excel document; however, you might want to resize it at a later time.

Applies to: The information in this topic applies to document-level projects and application-level projects for Excel 2007 and Excel 2010. For more information, see Features Available by Office Application and Project Type.

You can resize a named range at design time or at run time in document-level projects. You can also resize named ranges at run time in application-level add-ins.

This topic describes the following tasks:

You can resize a named range by redefining its size in the Define Name dialog box.

To resize a named range by using the Define Name dialog box

  1. Right-click a NamedRange control.

  2. Click Manage Named Ranges on the shortcut menu.

    The Define Name dialog box appears.

  3. Select the named range you want to resize.

  4. Clear the Refers to box.

  5. Select the cells you want to use to define the size of the named range.

  6. Click OK.

You can resize a named range programmatically by using the RefersTo property.

NoteNote

In the Properties window, the RefersTo property is marked as read-only.

To resize a named range programmatically

  1. Create a NamedRange control on cell A1 of Sheet1.

    
    Microsoft.Office.Tools.Excel.NamedRange NamedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", missing], "NamedRange1");
    
    
    
  2. Resize the named range to include cell B1.

    
    NamedRange1.RefersTo = "=Sheet1!$A$1:$B$1";
    
    
    

You can resize a NamedRange control on any open worksheet at run time. For more information about how to add a NamedRange control to a worksheet by using an application-level add-in, see How to: Add NamedRange Controls to Worksheets.

To resize a named range programmatically

  1. Create a NamedRange control on cell A1 of Sheet1.

    
    // Use the following line of code in projects that target the .NET Framework 4.
    Worksheet worksheet = Globals.Factory.GetVstoObject(Application.ActiveSheet);
    
    // In projects that target the .NET Framework 3.5, use the following line of code.
    // Worksheet worksheet = ((Excel.Worksheet)Application.ActiveSheet).GetVstoObject();
    
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 = worksheet.Controls.AddNamedRange(
        worksheet.Range["A1", missing], "MyNamedRange");
    
    
    
  2. Resize the named range to include cell B1.

    
    namedRange1.RefersTo = "=Sheet1!$A$1:$B$1";
    
    
    
Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft