NamedRange.Offset Свойство (2007 System)

Статья
11/16/2008

Обновлен: Июль 2008

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

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

Синтаксис

'Декларация
<BrowsableAttribute(False)> _
Public ReadOnly Property Offset As NamedRange..::._OffsetType
'Применение
Dim instance As NamedRange
Dim value As NamedRange..::._OffsetType

value = instance.Offset

[BrowsableAttribute(false)]
public 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 Tools for Office и не предназначен для использования непосредственно из кода.

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

Сведения о необязательных параметрах см. в разделе Общие сведения о необязательных параметрах в решениях 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 vstoWorksheet As Worksheet = CType( _
        Me.Application.ActiveWorkbook.Worksheets(1),  _
        Excel.Worksheet).GetVstoObject()
    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 = ((Excel.Worksheet)
        this.Application.ActiveWorkbook.Worksheets[1]).GetVstoObject();
    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();
}

Разрешения

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

См. также

Ссылки

NamedRange Класс

NamedRange - члены

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

Журнал изменений

Дата	Журнал событий	Причина
Июль 2008	Добавлена версия кода для надстройки уровня приложения.	Изменение функции SP1.

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