WorkbookBase.IconSets-Eigenschaft

Artikel
08/10/2011

Ruft die Auflistung der integrierten Symbolsätze ab, mit denen eine bedingte Formatierungsregel für einen Bereich in der Arbeitsmappe übernommen werden kann.

Namespace: Microsoft.Office.Tools.Excel
Assembly: Microsoft.Office.Tools.Excel.v4.0.Utilities (in Microsoft.Office.Tools.Excel.v4.0.Utilities.dll)

Syntax

'Declaration
Public ReadOnly Property IconSets As IconSets
    Get

public IconSets IconSets { get; }

Eigenschaftswert

Typ: Microsoft.Office.Interop.Excel.IconSets
Eine Microsoft.Office.Interop.Excel.IconSets-Auflistung mit den integrierten Symbolsatzobjekten, mit denen für einen Bereich eine bedingte Formatierungsregel übernommen werden kann.

Hinweise

Mit einem Symbolsatz können Bereichsdaten in drei bis fünf Kategorien klassifiziert werden, die durch Schwellenwerte getrennt sind. Jedes Symbol stellt einen Wertbereich dar. Im Microsoft.Office.Interop.Excel.XlIconSet.xl3Arrows-Symbolsatz werden durch den roten Aufwärtspfeil höhere, durch den gelben zur Seite zeigenden Pfeil mittlere und durch den grünen Abwärtspfeil niedrigere Werte dargestellt.

Soll eine bedingte Formatierungsregel auf Basis eines Symbolsatzes übernommen werden, muss mithilfe der Microsoft.Office.Interop.Excel.FormatConditions.AddIconSetCondition-Methode der FormatConditions-Eigenschaft eines Bereichs oder der FormatConditions-Eigenschaft eines benannten Bereichs eine neue Microsoft.Office.Interop.Excel.IconSetCondition erstellt werden. Legen Sie die Microsoft.Office.Interop.Excel.IconSetCondition.IconSet-Eigenschaft anschließend auf ein Microsoft.Office.Interop.Excel.IconSet-Objekt fest, das von der IconSets-Eigenschaft abgerufen wird. Wenn Sie das abzurufende Microsoft.Office.Interop.Excel.IconSet-Objekt angeben möchten, übergeben Sie der IconSets-Eigenschaft als Index einen der Microsoft.Office.Interop.Excel.XlIconSet-Enumerationswerte.

Beispiele

Im folgenden Codebeispiel wird ein Bereich in Sheet1 mit Werten von 1 bis 6 aufgefüllt. Das Beispiel fügt dann dem Bereich A1:A6 eine Symbolsatzbedingung mit dem Microsoft.Office.Interop.Excel.XlIconSet.xl3Arrows-Symbolsatz hinzu.

Dieses Beispiel bezieht sich auf eine Anpassung auf Dokumentebene.

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-Sicherheit

Volle Vertrauenswürdigkeit für den unmittelbaren Aufrufer. Dieser Member kann von nur teilweise vertrauenswürdigem Code nicht verwendet werden. Weitere Informationen finden Sie unter Verwenden von Bibliotheken aus teilweise vertrauenswürdigem Code.

Siehe auch

Referenz

WorkbookBase Klasse

Microsoft.Office.Tools.Excel-Namespace

Freigeben über