Excel アドインの空白値と null 値

null と空の文字列は、Excel JavaScript API では特別な意味を持ちます。 これらは、空のセル、書式設定なし、既定値を表すために使用されます。 このセクションでは、プロパティの取得や設定を行うときに null や空の文字列を使用する方法について詳しく説明します。

2 次元配列での null の入力

Excel では、範囲は 2 次元配列で表され、最初のディメンションは行、2 番目のディメンションは列を示します。 範囲内の特定のセルだけに値、数値書式、または数式を設定するには、2 次元配列内のそのセルに値、数値書式、または数式を指定し、2 次元配列内のその他のすべてのセルに null を指定します。

たとえば、範囲内の 1 つのセルの数値書式を更新し、範囲内の他のセルすべての既存の数値書式を保持する場合、更新するセルに新しい数値書式を指定し、他のセルすべてに null を指定します。 次のコード スニペットでは、範囲内の 4 番目のセルに新しい数値書式を設定し、その前の 3 つのセルについては数値書式を変更せずに保持します。

range.values = [['Eurasia', '29.96', '0.25', '15-Feb' ]];
range.numberFormat = [[null, null, null, 'm/d/yyyy;@']];

プロパティに対する null の入力

null は単一プロパティに有効な入力ではありません。 たとえば、範囲の プロパティを にnull設定できないため、values次のコード スニペットは無効です。

range.values = null; // This is not a valid snippet. 

同様に、次のコード スニペットは、null が color プロパティで有効な値ではないため無効です。

range.format.fill.color =  null;  // This is not a valid snippet. 

応答内の null プロパティ値

指定の範囲に複数の値がある場合、size および color などの書式設定プロパティでは、応答に null 値が含まれます。 たとえば、範囲を取得してその format.font.color プロパティを読み込む場合:

• 範囲内のすべてのセルのフォントの色が同じ場合、range.format.font.color がその色を指定します。
• 範囲内に複数のフォントの色がある場合、range.format.font.color は null です。

プロパティに対する空白の入力

プロパティに空白の値 ('' の間にスペースのない 2 つの引用符) を指定すると、プロパティをクリアまたはリセットする指示として解釈されます。 例:

• 範囲の values プロパティに空白の値を指定すると、範囲のコンテンツはクリアされます。
• numberFormat プロパティに空白の値を指定すると、数値書式は General にリセットされます。
• formula プロパティと formulaLocale プロパティに空白の値を指定すると、数式の値はクリアされます。

応答内の空白のプロパティ値

読み取り操作では、応答内の空白のプロパティ値 ('' の間にスペースのない、2 つの引用符) は、セルにデータまたは値がないことを示します。 次の 1 番目の例では、範囲内の最初と最後のセルにデータがありません。 2 番目の例では、範囲内の最初の 2 つのセルに数式がありません。

range.values = [['', 'some', 'data', 'in', 'other', 'cells', '']];

range.formula = [['', '', '=Rand()']];