NamedRange.SpecialCells(XlCellType, Object) Method

  • Reference

Definition

Namespace:
Microsoft.Office.Tools.Excel
Assembly:
Microsoft.Office.Tools.Excel.dll

Gets a Range object that represents all the cells that match the specified type and value.

public Microsoft.Office.Interop.Excel.Range SpecialCells (Microsoft.Office.Interop.Excel.XlCellType Type, object Value);
abstract member SpecialCells : Microsoft.Office.Interop.Excel.XlCellType * obj -> Microsoft.Office.Interop.Excel.Range
Public Function SpecialCells (Type As XlCellType, Optional Value As Object) As Range

Parameters

Type
XlCellType

The cells to include.Can be one of the following XlCellType values: xlCellTypeAllFormatConditions. Cells of any format. xlCellTypeAllValidation. Cells that have validation criteria. xlCellTypeBlanks. Empty cells. xlCellTypeComments. Cells that contain notes. xlCellTypeConstants. Cells that contain constants. xlCellTypeFormulas. Cells that contain formulas. xlCellTypeLastCell. The last cell in the used range. xlCellTypeSameFormatConditions. Cells that have the same format. xlCellTypeSameValidation. Cells that have the same validation criteria. xlCellTypeVisible. All visible cells.

Value
Object

If Type is either xlCellTypeConstants or xlCellTypeFormulas, this argument is used to determine which types of cells to include in the result. These values can be added together to return more than one type. The default is to select all constants or formulas, no matter what the type. Can be one of the following XlSpecialCellsValue values: xlErrorsxlLogicalxlNumbersxlTextValues

Returns

Range

A Range object that represents all the cells that match the specified type and value.

Examples

The following code example creates a NamedRange and then uses the SpecialCells method to select the last used cell in the NamedRange.

This example is for a document-level customization.

private void SelectLastCell()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A20"],
        "namedRange1");
    namedRange1.Value2 = 100;

    Excel.Range lastCell = namedRange1.SpecialCells(
        Excel.XlCellType.xlCellTypeLastCell);
    lastCell.Select();
}

Private Sub SelectLastCell()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A20"), _
        "namedRange1")
    namedRange1.Value2 = 100

    Dim lastCell As Excel.Range = _
        namedRange1.SpecialCells( _
        Excel.XlCellType.xlCellTypeLastCell, )
    lastCell.Select()
End Sub

Remarks

Optional Parameters

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

Applies to