XmlMappedRange.BorderAround - метод

Статья
08/11/2011

Добавляет границу элемента управления XmlMappedRange и устанавливает свойства Color, LineStyle и Weight для новой границы.

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

Синтаксис

'Декларация
Function BorderAround ( _
    LineStyle As Object, _
    Weight As XlBorderWeight, _
    ColorIndex As XlColorIndex, _
    Color As Object _
) As Object

Object BorderAround(
    Object LineStyle,
    XlBorderWeight Weight,
    XlColorIndex ColorIndex,
    Object Color
)

Параметры

LineStyle
Тип: System.Object
Стиль линий для границы.Может иметь одно из следующих значений XlLineStyle:
xlContinuous
xlDash
xlDashDot
xlDashDotDot
xlDot
xlDouble
xlSlantDashDot
xlLineStyleNone

Weight
Тип: Microsoft.Office.Interop.Excel.XlBorderWeight
Вес границы.Может быть одна из следующих констант XlBorderWeight:
xlHairline
xlMedium
xlThick
xlThin

ColorIndex
Тип: Microsoft.Office.Interop.Excel.XlColorIndex
Цвет границы как указатель на текущую цветовую палитру или как константа XlColorIndex.Может быть одна из следующих констант XlColorIndex:
xlColorIndexAutomatic
xlColorIndexNone

Color
Тип: System.Object
Цвет границы как значение RGB.

Возвращаемое значение

Тип: System.Object

Заметки

Необходимо указывать один из режимов: ColorIndex или Color, но не оба сразу.

Можно указывать один из режимов: LineStyle или Weight, но не оба сразу. Если ни один из аргументов не указан, Microsoft Office Excel использует стиль линий и толщину по умолчанию.

Этот метод создает контур элемента управления XmlMappedRange, не заполняя его.

Чтобы удалить границу, можно установить свойство LineStyle в xlLineStyleNone для элемента управления XmlMappedRange.

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

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

Примеры

В следующем примере кода метод BorderAround используется для применения толстой линии границы вокруг XmlMappedRange. Затем пользователю предлагается удалить границу при помощи метода ClearFormats. В этом примере предполагается, что текущий лист содержит элемент управления XmlMappedRange с именем CustomerLastNameCell.

Private Sub SetBorder()
    Me.CustomerLastNameCell.BorderAround( _
        Weight:=Excel.XlBorderWeight.xlThick, _
        ColorIndex:=Excel.XlColorIndex.xlColorIndexAutomatic)

    If MessageBox.Show("Clear the border?", "Test", MessageBoxButtons.YesNo) = _
        DialogResult.Yes Then
        Me.CustomerLastNameCell.ClearFormats()
    End If
End Sub

private void SetBorder()
{
    this.CustomerLastNameCell.BorderAround(missing, 
        Excel.XlBorderWeight.xlThick, 
        Excel.XlColorIndex.xlColorIndexAutomatic, missing);

    if (MessageBox.Show("Clear the border?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        this.CustomerLastNameCell.ClearFormats();
    }
}

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

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

См. также

Ссылки

XmlMappedRange Интерфейс

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

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