アイコンセットルールを使用すると、値に基づくアイコンを表示できます。 アイコンの種類を指定できるほか、セルにアイコンだけを表示するか、またはアイコンとデータを表示するかを指定できます。 次の図は、アイコンと値を表示するアイコンセットルールを示します。
iconSetTypeメソッドおよびiconSetTypeクラスを使用して、さまざまな種類のアイコンセットを指定できます。 reverseIconOrderメソッドを使用すると、アイコンの順序を逆にできます。 showIconOnlyメソッドを使用すると、アイコンだけを表示するのか、またはアイコンとデータを表示するのかを指定できます。
アイコンセットルールには、カスタムアイコンを作成して使用することもできます。
コードの使用
次のサンプルコードは、アイコンセットルールを作成します。
| JavaScript |
コードのコピー
|
|---|---|
| activeSheet.setValue(0,0,1,3); activeSheet.setValue(1,0,15,3); activeSheet.setValue(2,0,25,3); activeSheet.setValue(3,0,-1,3); var iconSetRule = new GC.Spread.Sheets.ConditionalFormatting.IconSetRule(); iconSetRule.ranges([new GC.Spread.Sheets.Range(0,0,4,1)]); iconSetRule.iconSetType(GC.Spread.Sheets.ConditionalFormatting.IconSetType.FourTrafficLights); var iconCriteria = iconSetRule.iconCriteria(); iconCriteria[0] = new GC.Spread.Sheets.ConditionalFormatting.IconCriterion(true, GC.Spread.Sheets.ConditionalFormatting.IconValueType.Number, 1); iconCriteria[1] = new GC.Spread.Sheets.ConditionalFormatting.IconCriterion(true, GC.Spread.Sheets.ConditionalFormatting.IconValueType.Number, 10); iconCriteria[2] = new GC.Spread.Sheets.ConditionalFormatting.IconCriterion(true, GC.Spread.Sheets.ConditionalFormatting.IconValueType.Number, 20); iconSetRule.reverseIconOrder(false); iconSetRule.showIconOnly(false); activeSheet.conditionalFormats.addRule(iconSetRule); |
|
コードの使用
次のサンプルコードは、アイコンセットルールのためにカスタムアイコンを作成します。
| JavaScript |
コードのコピー
|
|---|---|
|
activeSheet.setValue(0,0,1,3); var base = GC.Spread.Sheets.ConditionalFormatting.IconSetRule.getIcon; var iconSetRule = new GC.Spread.Sheets.ConditionalFormatting.IconSetRule(); |
|