Excel JavaScript API 1.6 の新機能

条件付き書式

範囲の条件付き書式を導入します。 次の種類の条件付き書式を使用できます。

  • カラー スケール
  • データ バー
  • アイコン セット
  • カスタム

さらに、次の機能も使用できます。

  • 条件付き書式が適用された範囲を返す。
  • 条件付き書式を削除する。
  • 優先度と stopifTrue 機能を提供します。
  • 指定した範囲のすべての条件付き書式のコレクションを取得する。
  • 現在指定している範囲でアクティブなすべての条件付き書式をクリアする。

API リスト

次の表に、Excel JavaScript API 要件セット 1.6 の API を示します。 Excel JavaScript API 要件セット 1.6 以前でサポートされているすべての API の API リファレンス ドキュメントを表示するには、 要件セット 1.6 以前の Excel API を参照してください。

クラス フィールド 説明
Application suspendApiCalculationUntilNextSync() 次の context.sync() が呼び出されるまで計算を中断します。
CellValueConditionalFormat format 条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する書式オブジェクトを返します。
ルール この条件付き書式のルール オブジェクトを指定します。
ColorScaleConditionalFormat criteria カラー スケールの条件。
threeColorScale trueの場合、カラー スケールには 3 つの点 (最小値、中間値、最大値) があります。それ以外の場合は 2 点 (最小値、最大値) になります。
ConditionalCellValueRule 数式 1 必要な場合、条件付き書式ルールを評価する数式。
数式 2 必要な場合、条件付き書式ルールを評価する数式。
operator セル値の条件付き書式の演算子。
ConditionalColorScaleCriteria maximum カラー スケール条件の最大点。
中点 カラー スケールが 3 色スケールの場合は、カラー スケール条件の中点。
minimum カラー スケール条件の最小点。
ConditionalColorScaleCriterion color カラー スケール色の HTML カラー コード表現 (例: #FF0000 は赤を表します)。
formula 数値、数式、または null ( type が lowestValueの場合)。
type 条件の条件付き数式の基準となるもの。
ConditionalDataBarNegativeFormat borderColor 境界線の色を表す HTML カラー コード。形式は #RRGGBB (例: "FFA500")、または名前付き HTML カラー (例: "オレンジ") です。
fillColor 塗りつぶしの色を表す HTML カラー コード。形式は #RRGGBB (例: "FFA500")、または名前付き HTML 色 (例: "オレンジ") です。
matchPositiveBorderColor 負のデータ バーの境界色を正のデータ バーと同じにするかどうかを指定します。
matchPositiveFillColor 負のデータ バーの塗りつぶしの色を正のデータ バーと同じにするかどうかを指定します。
ConditionalDataBarPositiveFormat borderColor 境界線の色を表す HTML カラー コード。形式は #RRGGBB (例: "FFA500")、または名前付き HTML カラー (例: "オレンジ") です。
fillColor 塗りつぶしの色を表す HTML カラー コード。形式は #RRGGBB (例: "FFA500")、または名前付き HTML 色 (例: "オレンジ") です。
gradientFill データ バーにグラデーションがあるかどうかを指定します。
ConditionalDataBarRule formula 必要な場合、データ バー ルールを評価する数式。
type データ バーのルールの種類。
ConditionalFormat cellValue 現在の条件付き書式が CellValue 型の場合、セル値の条件付き書式プロパティを返します。
cellValueOrNullObject 現在の条件付き書式が CellValue 型の場合、セル値の条件付き書式プロパティを返します。
colorScale 現在の条件付き書式が ColorScale 型の場合、カラー スケールの条件付き書式プロパティを返します。
colorScaleOrNullObject 現在の条件付き書式が ColorScale 型の場合、カラー スケールの条件付き書式プロパティを返します。
カスタム 現在の条件付き書式がカスタム型の場合、カスタム条件付き書式プロパティを返します。
customOrNullObject 現在の条件付き書式がカスタム型の場合、カスタム条件付き書式プロパティを返します。
dataBar 現在の条件付き書式がデータ バーの場合、データ バーのプロパティを返します。
dataBarOrNullObject 現在の条件付き書式がデータ バーの場合、データ バーのプロパティを返します。
delete() この条件付き書式を削除します。
getRange() 条件付き書式が適用された範囲を返す。
getRangeOrNullObject() 条件付き書式が適用される範囲を返します。
iconSet 現在の条件付き書式が IconSet 型の場合、アイコン セットの条件付き書式プロパティを返します。
iconSetOrNullObject 現在の条件付き書式が IconSet 型の場合、アイコン セットの条件付き書式プロパティを返します。
id 現在の ConditionalFormatCollectionの条件付き書式の優先順位。
プリセット 事前設定された条件の条件付き書式を返します。
presetOrNullObject 事前設定された条件の条件付き書式を返します。
priority この条件付き書式が現在存在する条件付き書式コレクション内の優先度 (またはインデックス)。
stopIfTrue この条件付き書式の条件が満たされた場合、優先順位の低い書式はそのセルに影響を及ぼしません。
textComparison 現在の条件付き書式がテキスト型の場合、特定のテキスト条件付き書式プロパティを返します。
textComparisonOrNullObject 現在の条件付き書式がテキスト型の場合、特定のテキスト条件付き書式プロパティを返します。
topBottom 現在の条件付き書式が TopBottom 型の場合、上位/下位の条件付き書式プロパティを返します。
topBottomOrNullObject 現在の条件付き書式が TopBottom 型の場合、上位/下位の条件付き書式プロパティを返します。
type 条件付き書式の一種。
ConditionalFormatCollection add(型: Excel.ConditionalFormatType) コレクションの最上位/最上位の優先順位で新しい条件付き書式を追加します。
clearAll() 現在指定している範囲でアクティブなすべての条件付き書式をクリアする。
getCount() ブック内の条件付き書式の数を返します。
getItem(id: string) 指定された ID に対応する条件付き書式を返します。
getItemAt(index: number) 指定されたインデックスに条件付き書式を返します。
items このコレクション内に読み込まれた子アイテムを取得します。
ConditionalFormatRule formula 必要な場合、条件付き書式ルールを評価する数式。
formulaLocal 必要な場合、ユーザーの言語で条件付き書式ルールを評価する数式。
formulaR1C1 必要な場合、R1C1 スタイルの表記で条件付き書式ルールを評価する数式。
ConditionalIconCriterion customIcon 現在の抽出条件のカスタム アイコン。既定のアイコン セットと異なる場合、それ以外の場合は null が返されます。
formula 種類によっては数値または数式。
operator greaterThan またはアイコンの条件付き書式のルール タイプごとに greaterThanOrEqual します。
type アイコンの条件式は次のものに基づいています。
ConditionalPresetCriteriaRule 基準 条件付き書式の条件。
ConditionalRangeBorder color 境界線の色を表す HTML カラー コード。形式は #RRGGBB (例: "FFA500")、または名前付き HTML カラー (例: "オレンジ") です。
sideIndex 罫線の特定の辺を表す定数値。
style 罫線の線スタイルを指定する、線スタイル定数のいずれか 1 つ。
ConditionalRangeBorderCollection bottom 下縁取りを取得します。
count コレクションに含まれる境界線オブジェクトの数。
getItem(index: Excel.ConditionalRangeBorderIndex) オブジェクトの名前を使用して、境界線オブジェクトを取得します。
getItemAt(index: number) オブジェクトのインデックスを使用して、境界線オブジェクトを取得します。
items このコレクション内に読み込まれた子アイテムを取得します。
left 左の境界線を取得します。
right 右縁取りを取得します。
top 上枠を取得します。
ConditionalRangeFill clear() 塗りつぶしをリセットします。
color 塗りつぶしの色を表す HTML カラー コード。形式は #RRGGBB (例: "FFA500")、または名前付き HTML 色 (例: "オレンジ") です。
ConditionalRangeFont bold フォントを太字にするかどうかを指定します。
clear() フォントの書式設定をリセットします。
color テキスト色の HTML カラー コード表現 (例: #FF0000 は赤を表します)。
italic フォントが斜体かどうかを指定します。
strikethrough フォントの取り消し線の状態を指定します。
underline フォントに適用される下線の種類。
ConditionalRangeFormat borders 条件付き書式全体の範囲に適用される罫線オブジェクトのコレクション。
fill 全体の条件付き書式範囲で定義された塗りつぶしオブジェクトを返します。
font 全体の条件付き書式範囲で定義されているフォント オブジェクトを返します。
numberFormat 指定された範囲に対する Excel の数値書式コードを表します。
ConditionalTextComparisonRule operator テキストの条件付き書式の演算子。
text 条件付き書式のテキスト値。
ConditionalTopBottomRule Rank 数値のランクに対する 1 から 1000、またはパーセントのランクに対する 1 から 100 のランク。
type 上位または下位のランクに基づいて値を書式設定します。
CustomConditionalFormat format 条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する書式オブジェクトを返します。
ルール この条件付き書式の Rule オブジェクトを指定します。
DataBarConditionalFormat axisColor 軸線の色を表す HTML カラー コード。形式は #RRGGBB (例: "FFA500")、または名前付き HTML 色 (例: "オレンジ") です。
axisFormat Excel データ バーの軸を決定する方法の表記。
barDirection データ バー グラフィックの基準となる方向を指定します。
lowerBoundRule データ バーの下限 (および該当する場合はその計算方法) を構成するルール。
negativeFormat Excel データ バーの軸の左側にあるすべての値の表現。
positiveFormat Excel データ バーの軸の右側にあるすべての値の表現。
showDataBarOnly true の場合、データ バーが適用されているセルの値を非表示にします。
upperBoundRule データ バーの上限値 (および該当する場合はその計算方法) を構成するルール。
IconSetConditionalFormat criteria ルールの条件とアイコン セット、および条件付きアイコンの潜在的なカスタム アイコンの配列。
reverseIconOrder true の場合、アイコン セットのアイコンの順序を逆にします。
showIconOnly true の場合、値は非表示になり、アイコンのみが表示されます。
style 設定されている場合は、条件付き書式のアイコン セット オプションを表示します。
PresetCriteriaConditionalFormat format 条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する書式オブジェクトを返します。
ルール 条件付き書式のルール。
Range calculate() ワークシート上のセルの範囲を計算します。
conditionalFormats 範囲と交差する ConditionalFormats のコレクション。
TextConditionalFormat format 条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する書式オブジェクトを返します。
ルール 条件付き書式のルール。
TopBottomConditionalFormat format 条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する書式オブジェクトを返します。
ルール 上位/下位の条件付き書式の条件。
ワークシート calculate(markAllDirty: boolean) ワークシート上のすべてのセルを計算します。

関連項目

  • 最終更新: