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

Статья
05/19/2013

Возвращает объект 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

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"], "offsetRange");

    Excel.Range activateRange =
        (Excel.Range)this.offsetRange.Offset[3, 3];
    offsetRange.Value2 = "Original range.";
    activateRange.Value2 = "Offset range.";
    activateRange.Select();
}

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

Безопасность платформы .NET Framework

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

См. также

Ссылки

NamedRange Интерфейс

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

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