NamedRange.Offset-Eigenschaft

Artikel
05/07/2013

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

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	Beschreibung
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"], "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.

.NET Framework-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

NamedRange Schnittstelle

Microsoft.Office.Tools.Excel-Namespace

Freigeben über