Propriedade NamedRange.Offset

Artigo
08/01/2011

Obtém um Microsoft.Office.Interop.Excel.Range que é deslocada a partir de NamedRange de controle.

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
    Get

NamedRange_OffsetType Offset { get; }

Valor de propriedade

Tipo: Microsoft.Office.Tools.Excel.NamedRange_OffsetType
A Microsoft.Office.Interop.Excel.Range que é deslocada a partir de NamedRange de controle.

Comentários

O Offset propriedade destina-se a ser usado com os seguintes parâmetros.

Parameter	Description
RowOffset	O número de linhas (positivo, negativo ou 0 (zero)) pelo qual o intervalo será deslocado. Valores positivos são deslocados para baixo e valores negativos são deslocados para cima. O valor padrão é 0.
ColumnOffset	O número de colunas (positivo, negativo ou 0 (zero)) pelo qual o intervalo será deslocado. Valores positivos são deslocados para a direita e os valores negativos são deslocados para a esquerda. O valor padrão é 0.

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

Optional Parameters

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

Exemplos

O exemplo de código a seguir cria um NamedRange e adiciona texto a um deslocamento de célula a partir de NamedRange por três colunas e três células.

Esta versão é para uma personalização em nível de 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();
}

Esta versão é um suplemento em nível de aplicativo.

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

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áveis.

Consulte também

Referência

NamedRange Interface

Namespace Microsoft.Office.Tools.Excel

Compartilhar via