WorkbookBase.IconSets - свойство

Статья
08/11/2011

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

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

Синтаксис

'Декларация
Public ReadOnly Property IconSets As IconSets
    Get

public IconSets IconSets { get; }

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

Тип: Microsoft.Office.Interop.Excel.IconSets
Коллекция Microsoft.Office.Interop.Excel.IconSets, содержащая встроенные объекты наборов значков, которые можно использовать для применения правил форматирования к диапазону ячеек в книге.

Заметки

Для классификации данных диапазона в несколько категорий (3–5), разделенных пороговыми значениями, можно использовать набор значков. Каждый значок представляет собой диапазон значений. Например, в наборе значков Microsoft.Office.Interop.Excel.XlIconSet.xl3Arrows красная стрелка "вверх" представляет более высокие значения, желтая стрелка "в сторону" — средние значения, а зеленая стрелка "вниз" — более низкие значения.

Чтобы применить условное правило форматирования, определяемое набором значков, необходимо создать новое условие Microsoft.Office.Interop.Excel.IconSetCondition, вызвав метод Microsoft.Office.Interop.Excel.FormatConditions.AddIconSetCondition свойства FormatConditions диапазона или свойства FormatConditions именованного диапазона. Затем следует задать свойство Microsoft.Office.Interop.Excel.IconSetCondition.IconSet для объекта Microsoft.Office.Interop.Excel.IconSet, извлеченного из свойства IconSets. Чтобы указать требуемый объект Microsoft.Office.Interop.Excel.IconSet, передайте одно из значений перечисления Microsoft.Office.Interop.Excel.XlIconSet в качестве индекса свойства IconSets.

Примеры

В следующем примере кода заполняется диапазон на листе Sheet1 значениями от 1 до 6. Затем пример добавляет условие набора значков к диапазону A1:A6 с набором значков Microsoft.Office.Interop.Excel.XlIconSet.xl3Arrows.

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

Private Sub SetIconSetCondition()
    ' Populate a range
    Dim i As Integer
    For i = 1 To 6
        Globals.Sheet1.Range("A" + i.ToString()).Value2 = i.ToString()
    Next

    ' Add an icon set condition to the range
    Dim iconSetCondition1 As Excel.IconSetCondition = _
    Globals.Sheet1.Range("A1", "A6").FormatConditions.AddIconSetCondition()
    iconSetCondition1.IconSet = Me.IconSets(Excel.XlIconSet.xl3Arrows)
End Sub

private void SetIconSetCondition()
{
    // Populate a range        
    for (int i=1;i<7;i++)
    {
        Globals.Sheet1.Range["A" + i.ToString(),missing].Value2 
            = i.ToString();
    }

    // Add an icon set condition to the range
    Excel.IconSetCondition iconSetCondition1 = 
        (Excel.IconSetCondition)
        Globals.Sheet1.Range["A1", "A6"].
        FormatConditions.AddIconSetCondition();
    iconSetCondition1.IconSet = 
        this.IconSets[Excel.XlIconSet.xl3Arrows];
}

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

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

См. также

Ссылки

WorkbookBase Класс

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

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