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

NamedRange.AutoFormat Метод (2007 System)

  • Статья

Обновлен: Ноябрь 2007

Автоматически форматирует элемент управления NamedRange с использованием предварительно определенного формата.

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

Синтаксис

'Декларация
Public Function AutoFormat ( _
    Format As XlRangeAutoFormat, _
    Number As Object, _
    Font As Object, _
    Alignment As Object, _
    Border As Object, _
    Pattern As Object, _
    Width As Object _
) As Object
'Применение
Dim instance As NamedRange
Dim Format As XlRangeAutoFormat
Dim Number As Object
Dim Font As Object
Dim Alignment As Object
Dim Border As Object
Dim Pattern As Object
Dim Width As Object
Dim returnValue As Object

returnValue = instance.AutoFormat(Format, _
    Number, Font, Alignment, Border, Pattern, _
    Width)

public Object AutoFormat(
    XlRangeAutoFormat Format,
    Object Number,
    Object Font,
    Object Alignment,
    Object Border,
    Object Pattern,
    Object Width
)

Параметры

  • Number
    Тип: System.Object
    Значение true для включения числовых форматов в автоформат. Значение по умолчанию — true.
  • Font
    Тип: System.Object
    Значение true для включения форматов шрифтов в автоформат. Значение по умолчанию — true.
  • Alignment
    Тип: System.Object
    Значение true для включения выравнивания в автоформат. Значение по умолчанию — true.
  • Border
    Тип: System.Object
    Значение true для включения форматов границ в автоформат. Значение по умолчанию — true.
  • Pattern
    Тип: System.Object
    Значение true для включения форматов шаблонов в автоформат. Значение по умолчанию — true.
  • Width
    Тип: System.Object
    Значение true для включения ширины столбцов и высоты строк в автоформат. Значение по умолчанию — true.

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

Тип: System.Object

Заметки

Если диапазон включает в себя одну ячейку, данный метод также форматирует активную область вокруг этой ячейки.

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

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

Примеры

В следующем примере кода демонстрируется задание ряда характеристик форматирования и отображения элемента управления NamedRange с именем NamedRange1. В частности, в данном примере метод AutoFormat применяется для форматирования NamedRange1 с использованием формата xlRangeAutoFormat3DEffects1.

В этом примере демонстрируется настройка уровня документа.

Private Sub SetRangeFormats()
    Dim namedRange1 As Microsoft.Office.Tools.Excel.NamedRange _
        = Me.Controls.AddNamedRange(Me.Range("A1", "A5"), _
        "namedRange1")

    namedRange1.NoteText("This is a Formatting test", , )
    namedRange1.Value2 = "Martha"
    namedRange1.Font.Name = "Verdana"
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter
    namedRange1.BorderAround(, Excel.XlBorderWeight.xlThick, _
        Excel.XlColorIndex.xlColorIndexAutomatic, )
    namedRange1.AutoFormat( _
        Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1, _
        True, False, True, False, True, True)

    If MessageBox.Show("Clear the formatting and notes?", _
        "Test", MessageBoxButtons.YesNo) = DialogResult.Yes Then
        namedRange1.ClearFormats()
        namedRange1.ClearNotes()
    End If
End Sub


private void SetRangeFormats()
{
    Microsoft.Office.Tools.Excel.NamedRange namedRange1 =
        this.Controls.AddNamedRange(this.Range["A1", "A5"],
        "namedRange1");

    namedRange1.NoteText("This is a Formatting test", missing, missing);
    namedRange1.Value2 = "Martha";
    namedRange1.Font.Name = "Verdana";
    namedRange1.VerticalAlignment = Excel.XlVAlign.xlVAlignCenter;
    namedRange1.HorizontalAlignment = Excel.XlHAlign.xlHAlignCenter;
    namedRange1.BorderAround(missing, Excel.XlBorderWeight.xlThick,
        Excel.XlColorIndex.xlColorIndexAutomatic, missing);
    namedRange1.AutoFormat(Excel.XlRangeAutoFormat.xlRangeAutoFormat3DEffects1,
        true, false, true, false, true, true);

    if (MessageBox.Show("Clear the formatting and notes?", "Test",
        MessageBoxButtons.YesNo) == DialogResult.Yes)
    {
        namedRange1.ClearFormats();
        namedRange1.ClearNotes();
    }
}

Разрешения

См. также

Ссылки

NamedRange Класс

NamedRange - члены

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