Propriedade NamedRange.Offset

Artigo
01/09/2014

Obtém Microsoft.Office.Interop.Excel.Range que é deslocado de controle de NamedRange .

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

Sintaxe

'Declaração
ReadOnly Property Offset As NamedRange_OffsetType

NamedRange_OffsetType Offset { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.NamedRange_OffsetType
Microsoft.Office.Interop.Excel.Range que é deslocado de controle de NamedRange .

Comentários

A propriedade de Offset destina-se a ser usada com os seguintes parâmetros.

Parâmetro	Descrição
RowOffset	O número de linhas (positivo, negativo, ou 0 (zero)) por que o intervalo deve ser deslocado. Os valores positivos são deslocados para baixo, e os valores negativos são deslocados para cima. O valor padrão é 0.
ColumnOffset	O número de colunas (positivo, negativo, ou 0 (zero)) por que o intervalo deve ser deslocado. Os valores positivos são deslocados à direita, e os valores negativos são deslocados à esquerda. O valor padrão é 0.

Se você tentar usar Offset sem especificar quaisquer parâmetros, Offset obterá um objeto de NamedRange_OffsetType que é parte da infraestrutura do Visual Studio e não destina-se a ser usado diretamente do seu código.

Parâmetros Opcionais

Para obter informações sobre parâmetros opcionais, consulte Parâmetros opcionais em soluções do Office.

Exemplos

O exemplo de código a seguir cria NamedRange e então adiciona texto a uma célula deslocada de NamedRange por três colunas e três por células.

Esta é uma versão para personalização de um documento nível.

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

Esta versão é para um suplemento ao aplicativo.

Segurança do .NET Framework

Confiança total para o chamador imediato. O membro não pode ser usado por código parcialmente confiável. Para obter mais informações, consulte Usando bibliotecas de código parcialmente confiável.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via