NamedRange.Item (Propiedad)
Obtiene un objeto Microsoft.Office.Interop.Excel.Range que representa un rango en un desplazamiento del control NamedRange.
Espacio de nombres: Microsoft.Office.Tools.Excel
Ensamblado: Microsoft.Office.Tools.Excel (en Microsoft.Office.Tools.Excel.dll)
Sintaxis
'Declaración
ReadOnly Property Item As NamedRange_ItemType
Get
NamedRange_ItemType Item { get; }
Valor de propiedad
Tipo: Microsoft.Office.Tools.Excel.NamedRange_ItemType
Objeto Microsoft.Office.Interop.Excel.Range que representa un rango en un desplazamiento del control NamedRange.
Comentarios
La propiedad Item está pensada para utilizarse con los parámetros siguientes.
Parámetro |
Descripción |
---|---|
RowIndex |
El número de índice de la celda a la que desea obtener acceso, en orden de izquierda a derecha. NamedRange.Item(1) devuelve la celda superior izquierda del rango; NamedRange.Item(2) devuelve la celda situada inmediatamente a la derecha de la celda superior izquierda. |
ColumnIndex |
Número o cadena que indica el número de columnas de la celda a la que se desea obtener acceso, empezando por 1 o "A" para la primera columna del rango. |
Si intenta usar Item sin especificar parámetros, Item obtendrá un objeto NamedRange_ItemType que forma parte de la infraestructura de Visual Studio y que no está diseñado para usarlo directamente en el código.
Los argumentos RowIndex y ColumnIndex son los desplazamiento relativos. Es decir, al especificar un valor de 1 para RowIndex se devuelven celdas de la primera fila del rango, no de la primera fila de la hoja de cálculo.
Ejemplos
En el siguiente ejemplo de código se crea NamedRange y, a continuación, se utiliza la propiedad Item para seleccionar la celda desplazada de NamedRange tres columnas y tres filas.
Se trata de una versión para una personalización en el nivel del documento.
Private itemRange As Microsoft.Office.Tools.Excel.NamedRange
Private Sub SelectItem()
itemRange = Me.Controls.AddNamedRange( _
Me.Range("A1"), "itemRange")
itemRange.Value2 = "NamedRange"
Dim offsetCell As Excel.Range = _
CType(Me.itemRange.Item(3, 3), Excel.Range)
offsetCell.Value2 = "Offset cell."
offsetCell.Select()
End Sub
Microsoft.Office.Tools.Excel.NamedRange itemRange;
private void SelectItem()
{
itemRange = this.Controls.AddNamedRange(
this.Range["A1", missing], "itemRange");
itemRange.Value2 = "NamedRange";
Excel.Range offsetCell =
(Excel.Range)this.itemRange.Item[3, 3];
offsetCell.Value2 = "Offset cell.";
offsetCell.Select();
}
Se trata de una versión para un complemento en el nivel de la aplicación.
Private itemRange As NamedRange
Private Sub SelectItem()
Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveSheet
Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
Globals.Factory.GetVstoObject(NativeWorksheet)
itemRange = vstoWorksheet.Controls.AddNamedRange( _
vstoWorksheet.Range("A1"), "itemRange")
itemRange.Value2 = "NamedRange"
Dim offsetCell As Excel.Range = _
CType(Me.itemRange.Item(3, 3), Excel.Range)
offsetCell.Value2 = "Offset cell."
offsetCell.Select()
End Sub
NamedRange itemRange;
private void SelectItem()
{
Worksheet vstoWorksheet =
Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]);
itemRange = vstoWorksheet.Controls.AddNamedRange(
vstoWorksheet.Range["A1", missing], "itemRange");
itemRange.Value2 = "NamedRange";
Excel.Range offsetCell =
(Excel.Range)itemRange.Item[3, 3];
offsetCell.Value2 = "Offset cell.";
offsetCell.Select();
}
Seguridad de .NET Framework
- Plena confianza para el llamador inmediato. Un código de confianza parcial no puede utilizar este miembro. Para obtener más información, vea Utilizar bibliotecas de código que no es de plena confianza.