NamedRange.Offset (Propiedad)
Obtiene un objeto Microsoft.Office.Interop.Excel.Range desplazado 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 Offset As NamedRange_OffsetType
Get
NamedRange_OffsetType Offset { get; }
Valor de propiedad
Tipo: Microsoft.Office.Tools.Excel.NamedRange_OffsetType
Objeto Microsoft.Office.Interop.Excel.Range desplazado del control NamedRange.
Comentarios
La propiedad Offset está pensada para utilizarse con los parámetros siguientes.
Parámetro |
Descripción |
|---|---|
RowOffset |
El número de filas [positivo, negativo o 0 (cero)] que se va a desplazar el rango. Los valores positivos indican un desplazamiento hacia abajo y los negativos, hacia arriba. El valor predeterminado es 0. |
ColumnOffset |
El número de columnas [positivo, negativo o 0 (cero)] que se va a desplazar el rango. Los valores positivos indican un desplazamiento a la derecha y los negativos, a la izquierda. El valor predeterminado es 0. |
Si intenta usar Offset sin especificar parámetros, Offset obtendrá un objeto NamedRange_OffsetType que forma parte de la infraestructura de Visual Studio y que no está diseñado para usarlo directamente en el código.
Parámetros opcionales
Para obtener información sobre parámetros opcionales, vea Parámetros opcionales en las soluciones de Office.
Ejemplos
En el ejemplo de código siguiente se crea NamedRange y, a continuación, se agrega texto a un desplazamiento de celda desde NamedRange en tres columnas y tres celdas.
Se trata de una versión para una personalización en el nivel del documento.
Private offsetRange As Microsoft.Office.Tools.Excel.NamedRange
Private Sub ActivateOffset()
offsetRange = Me.Controls.AddNamedRange( _
Me.Range("B1"), "offsetRange")
Dim activateRange As Excel.Range = _
CType(Me.offsetRange.Offset(3, 3), Excel.Range)
offsetRange.Value2 = "Original range."
activateRange.Value2 = "Offset range."
activateRange.Select()
End Sub
Microsoft.Office.Tools.Excel.NamedRange offsetRange;
private void ActivateOffset()
{
offsetRange = this.Controls.AddNamedRange(
this.Range["B1", missing], "offsetRange");
Excel.Range activateRange =
(Excel.Range)this.offsetRange.Offset[3, 3];
offsetRange.Value2 = "Original range.";
activateRange.Value2 = "Offset range.";
activateRange.Select();
}
Se trata de una versión para un complemento en el nivel de la aplicación.
Private offsetRange As NamedRange
Private Sub ActivateOffset()
Dim NativeWorksheet As Microsoft.Office.Interop.Excel.Worksheet =
Globals.ThisAddIn.Application.ActiveSheet
Dim vstoWorksheet As Microsoft.Office.Tools.Excel.Worksheet =
Globals.Factory.GetVstoObject(NativeWorksheet)
offsetRange = vstoWorksheet.Controls.AddNamedRange( _
vstoWorksheet.Range("B1"), "offsetRange")
Dim activateRange As Excel.Range = _
CType(offsetRange.Offset(3, 3), Excel.Range)
offsetRange.Value2 = "Original range."
activateRange.Value2 = "Offset range."
activateRange.Select()
End Sub
NamedRange offsetRange;
private void ActivateOffset()
{
Worksheet vstoWorksheet =
Globals.Factory.GetVstoObject(this.Application.ActiveWorkbook.Worksheets[1]);
offsetRange = vstoWorksheet.Controls.AddNamedRange(
vstoWorksheet.Range["B1", missing], "offsetRange");
Excel.Range activateRange =
(Excel.Range)offsetRange.Offset[3, 3];
offsetRange.Value2 = "Original range.";
activateRange.Value2 = "Offset range.";
activateRange.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.