NamedRange.Offset, propriété

  • Article

Obtient un Microsoft.Office.Interop.Excel.Range présentant un offset par rapport au contrôle NamedRange.

Espace de noms :  Microsoft.Office.Tools.Excel
Assembly :  Microsoft.Office.Tools.Excel (dans Microsoft.Office.Tools.Excel.dll)

Syntaxe

'Déclaration
ReadOnly Property Offset As NamedRange_OffsetType
    Get

NamedRange_OffsetType Offset { get; }

Valeur de propriété

Type : Microsoft.Office.Tools.Excel.NamedRange_OffsetType
Microsoft.Office.Interop.Excel.Range présentant un offset par rapport au contrôle NamedRange.

Notes

La propriété Offset doit être utilisée avec les paramètres suivants.

Paramètre

Description

RowOffset

Nombre de lignes (positif, négatif ou zéro) représentant l'offset de la plage. Les valeurs positives sont décalées vers le bas et les valeurs négatives vers le haut. La valeur par défaut est 0.

ColumnOffset

Nombre de colonnes (positif, négatif ou zéro) représentant l'offset de la plage. Les valeurs positives sont décalées vers la droite et les valeurs négatives vers la gauche. La valeur par défaut est 0.

Si vous essayez d'utiliser Offset sans spécifier de paramètres, Offset obtiendra un objet NamedRange_OffsetType qui fait partie de l'infrastructure Visual Studio et n'est pas conçu pour être utilisé directement à partir de votre code.

Paramètres optionnels

Pour plus d'informations sur les paramètres optionnels, consultez Paramètres optionnels dans les solutions Office.

Exemples

L'exemple de code suivant crée un NamedRange, puis ajoute du texte dans une cellule présentant un offset de trois colonnes et de trois cellules par rapport à NamedRange.

Cette version est destinée à une personnalisation au niveau du document.

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

Cette version est destinée à un complément d'application.

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

Sécurité .NET Framework

Voir aussi

Référence

NamedRange Interface

Microsoft.Office.Tools.Excel, espace de noms