Proprietà NamedRange.Offset

  • Articolo

Ottiene un oggetto Microsoft.Office.Interop.Excel.Range spostato rispetto al controllo NamedRange.

Spazio dei nomi:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Sintassi

'Dichiarazione
ReadOnly Property Offset As NamedRange_OffsetType
    Get

NamedRange_OffsetType Offset { get; }

Valore proprietà

Tipo: Microsoft.Office.Tools.Excel.NamedRange_OffsetType
Oggetto Microsoft.Office.Interop.Excel.Range spostato rispetto al controllo NamedRange.

Note

La proprietà Offset deve essere utilizzata con i parametri riportati di seguito.

Parametro

Oggetto di descrizione

RowOffset

Numero di righe (positivo, negativo o 0 (zero)) in base al quale spostare l'intervallo. I valori positivi indicano uno spostamento verso il basso, mentre i numeri negativi indicano uno spostamento verso l'alto. Il valore predefinito è 0.

ColumnOffset

Numero di colonne (positivo, negativo o 0 (zero)) in base al quale spostare l'intervallo. I valori positivi indicano uno spostamento verso destra, mentre i numeri negativi indicano uno spostamento verso sinistra. Il valore predefinito è 0.

Se si tenta di utilizzare Offset senza specificare alcun parametro, Offset otterrà un oggetto NamedRange_OffsetType che fa parte dell'infrastruttura di Visual Studio e non può essere utilizzato direttamente dal codice.

Parametri facoltativi

Per informazioni sui parametri facoltativi, vedere Parametri facoltativi nelle soluzioni Office.

Esempi

Nell'esempio di codice riportato di seguito viene creato un controllo NamedRange. Viene quindi aggiunto testo a una cella spostata di tre colonne e tre righe rispetto al controllo NamedRange.

Questa versione è valida per una personalizzazione a livello di 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();
}

Questa versione è valida per un componente aggiuntivo a livello di applicazione.

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();
}

Sicurezza di .NET Framework

Vedere anche

Riferimenti

NamedRange Interfaccia

Spazio dei nomi Microsoft.Office.Tools.Excel