XmlMappedRange.SpecialCells(XlCellType, Object) Method

Reference

Definition

Namespace:: Microsoft.Office.Tools.Excel

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

Important

Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.

Gets a Range 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 having validation criteria. xlCellTypeBlanks. Empty cells. xlCellTypeComments. Cells containing notes. xlCellTypeConstants. Cells containing constants. xlCellTypeFormulas. Cells containing formulas. xlCellTypeLastCell. The last cell in the used range. xlCellTypeSameFormatConditions. Cells having the same format. xlCellTypeSameValidation. Cells having 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: xlErrors xlLogical xlNumbers xlTextValues

Returns

Range

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

Examples

The following code example uses the SpecialCells method to get and select the range of cells that contain comments within an XmlMappedRange. This code example assumes that the current worksheet contains an XmlMappedRange named CustomerLastNameCell.

private void SelectRangeWithComments()
{
    this.CustomerLastNameCell.AddComment("This cell contains " +
        "a last name.");

    Excel.Range range1 = this.CustomerLastNameCell.SpecialCells(
        Excel.XlCellType.xlCellTypeComments);
    range1.Select();
}

Private Sub SelectRangeWithComments()
    Me.CustomerLastNameCell.AddComment(("This cell contains " & _
        "a last name."))

    Dim range1 As Excel.Range = Me.CustomerLastNameCell.SpecialCells( _
        Excel.XlCellType.xlCellTypeComments)
    range1.Select()
End Sub

Remarks

Optional Parameters

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

Applies to