NamedRange.Offset-Eigenschaft

  • Artikel

Ruft einen Microsoft.Office.Interop.Excel.Range ab, der gegenüber dem NamedRange-Steuerelement versetzt ist.

Namespace:  Microsoft.Office.Tools.Excel
Assembly:  Microsoft.Office.Tools.Excel (in Microsoft.Office.Tools.Excel.dll)

Syntax

'Declaration
ReadOnly Property Offset As NamedRange_OffsetType
    Get

NamedRange_OffsetType Offset { get; }

Eigenschaftswert

Typ: Microsoft.Office.Tools.Excel.NamedRange_OffsetType
Ein Microsoft.Office.Interop.Excel.Range, der gegenüber dem NamedRange-Steuerelement versetzt ist.

Hinweise

Die Offset-Eigenschaft ist für die Verwendung mit den folgenden Parametern vorgesehen.

Parameter

Beschreibungen

RowOffset

Die Anzahl der Zeilen (positiv, negativ oder 0 (null)), um die der Bereich versetzt werden soll. Positive Werte bedeuten eine Verschiebung nach unten, negative Werte dagegen bedeuten eine Verschiebung nach oben. Der Standardwert ist 0.

ColumnOffset

Die Anzahl der Spalten (positiv, negativ oder 0 (null)), um die der Bereich versetzt werden soll. Positive Werte bedeuten eine Verschiebung nach rechts, negative Werte eine Verschiebung nach links. Der Standardwert ist 0.

Wenn Sie versuchen, Offset zu verwenden, ohne Parameter anzugeben, ruft Offset ein NamedRange_OffsetType-Objekt ab, das Teil der Visual Studio-Infrastruktur ist und nicht für die direkte Verwendung im Code vorgesehen ist.

Optionale Parameter

Informationen zu optionalen Parametern finden Sie unter Optionale Parameter in Office-Lösungen.

Beispiele

Im folgenden Codebeispiel wird ein NamedRange erstellt. Anschließend wird einer Zelle Text hinzugefügt, die gegenüber dem NamedRange um drei Spalten und drei Zeilen versetzt ist.

Diese Version bezieht sich auf eine Anpassung auf Dokumentebene.

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

Diese Version bezieht sich auf ein Add-In auf Anwendungsebene.

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

.NET Framework-Sicherheit

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace