NamedRange.Offset - свойство

Статья
08/11/2011

Возвращает объект Microsoft.Office.Interop.Excel.Range, являющийся смещением от элемента управления NamedRange.

Пространство имен: Microsoft.Office.Tools.Excel
Сборка: Microsoft.Office.Tools.Excel (в Microsoft.Office.Tools.Excel.dll)

Синтаксис

'Декларация
ReadOnly Property Offset As NamedRange_OffsetType
    Get

NamedRange_OffsetType Offset { get; }

Значение свойства

Тип: Microsoft.Office.Tools.Excel.NamedRange_OffsetType
Объект Microsoft.Office.Interop.Excel.Range, являющийся смещением от элемента управления NamedRange.

Заметки

Свойство Offset должно использоваться с указанными ниже параметрами.

Параметр	Описание
RowOffset	Число строк (положительное, отрицательное или равное нулю (0)), на которое должен быть смещен диапазон. При положительных значениях производится смещение вниз, при отрицательных — вверх. Значение по умолчанию — 0.
ColumnOffset	Число столбцов (положительное, отрицательное или равное нулю (0)), на которое должен быть смещен диапазон. При положительных значениях производится смещение вправо, при отрицательных — влево. Значение по умолчанию — 0.

При попытке использования свойства Offset без указания каких-либо параметров свойство Offset получит объект NamedRange_OffsetType, который является частью инфраструктуры Visual Studio и не предназначен для использования непосредственно из кода.

Необязательные параметры

Сведения о необязательных параметрах см. в разделе Необязательные параметры в решениях Office.

Примеры

В следующем примере кода создается NamedRange, а затем в ячейку, смещенную от NamedRange на три столбца и три ячейки, добавляется текст.

Эта версия предназначена для настройки уровня документа.

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

Эта версия предназначена для надстройки уровня приложения.

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

Полное доверие для непосредственно вызывающего метода. Этот член не может быть использован частично доверенным кодом. Дополнительные сведения см. в разделе Использование библиотек из не вполне надежного кода.

См. также

Ссылки

NamedRange Интерфейс

Microsoft.Office.Tools.Excel - пространство имен

Поделиться через