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 formula1 条件付き書式ルールを評価する数式 (必要な場合)。
formula2 条件付き書式ルールを評価する数式 (必要な場合)。
operator セル値の条件付き書式の演算子。
ConditionalColorScaleCriteria maximum カラー スケール条件の最大ポイント。
中点 カラー スケールが 3 色スケールの場合は、カラー スケール条件の中間点。
minimum カラー スケール基準の最小ポイント。
ConditionalColorScaleCriterion color カラー スケールの色の HTML カラー コード表現 (たとえば、#FF0000 は赤を表します)。
formula 数値、数式、または null (が のlowestValue場合type)。
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() conditonal 形式が適用される範囲を返します。
iconSet 現在の条件付き書式が型の場合は、アイコン セットの条件付き書式プロパティを IconSet 返します。
iconSetOrNullObject 現在の条件付き書式が型の場合は、アイコン セットの条件付き書式プロパティを IconSet 返します。
id 現在 ConditionalFormatCollectionの の条件付き書式の優先順位。
プリセット 事前設定された条件の条件付き形式を返します。
presetOrNullObject 事前設定された条件の条件付き形式を返します。
優先 順位 この条件付き書式が現在存在する条件付き書式コレクション内の優先順位 (またはインデックス)。
stopIfTrue この条件付き書式の条件が満たされた場合、優先順位の低い書式はそのセルに影響を及ぼしません。
textComparison 現在の条件付き書式がテキスト型の場合は、特定のテキスト条件付き書式プロパティを返します。
textComparisonOrNullObject 現在の条件付き書式がテキスト型の場合は、特定のテキスト条件付き書式プロパティを返します。
topBottom 現在の条件付き書式が型の場合は、上位/下位の条件付き書式プロパティを TopBottom 返します。
topBottomOrNullObject 現在の条件付き書式が型の場合は、上位/下位の条件付き書式プロパティを TopBottom 返します。
type 条件付き書式の種類。
ConditionalFormatCollection add(type: 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 色コード(例: "FFA500")、または名前付き HTML カラー (例: "オレンジ") として #RRGGBB。
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 条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する format オブジェクトを返します。
ルール 条件付き書式のルール。
TopBottomConditionalFormat format 条件付き書式のフォント、塗りつぶし、罫線、およびその他のプロパティをカプセル化する format オブジェクトを返します。
ルール 上/下の条件付き書式の条件。
ワークシート calculate(markAllDirty: boolean) ワークシート上のすべてのセルを計算します。

関連項目