Excel ドキュメントと財務文書、販売レポート、請求書、学生状況レポートやフォームなどのレポートを作成する場合、処理や計算に使用できる空または空白のセルではなく、事前に入力されたテキストまたは固定データを含むセルが必要になります。

デフォルト値はそのようなシナリオに役立ち、通常のセル値のように表示および計算に使用される値または数式を提供します。DioDocs for Excelでは、IRange インタフェースの DefaultValue プロパティを使用して、セルのデフォルト値を設定することができます。

デフォルト値には、以下に示す特定の特性があります。

• デフォルト値を使用して値と数式を設定できます。「=」で始まる文字列は数式とみなされます。
• セルが空の場合は、そのデフォルト値または数式が再計算に含まれます。
• デフォルト値の数式調整の論理は、セルの数式と同じです。
• Excel をエクスポートするときに、セルが空の場合は、DioDocs for Excel はデフォルト値をセル値としてエクスポートします。デフォルト値が数式の場合は、DioDocs for Excel は数式を破棄し、計算結果のみを保持します。
• デフォルト値に null を設定して、デフォルト値をクリアできます。
• Clear メソッドと UnMerge メソッドはデフォルト値に影響しません。このメソッドの実行後にデフォルト値が設定されます。

次のサンプルコードは、セルのデフォルト値を設定する方法を示しています。

// ワークブックを開きます。
var workbook = new Workbook();

// defaultValue.xlsx を開きます。
workbook.Open("defaultValue.xlsx");
var worksheet = workbook.ActiveSheet;
            
// デフォルト値を設定します。
worksheet.Range["C4:C8"].DefaultValue = "=B4 - B4*0.12";

// 特定のパーセント削減の通常値を設定します。
worksheet.Range["C6"].Formula = "=B6 - B6*0.08";
worksheet.Range["C8"].Formula = "=B8 - B8*0.05";

// デフォルト値と特定の値の合計を計算します。
worksheet.Range["C9"].Formula = "=SUM(C4:C8)";

// Excel ファイルに保存します。
workbook.Save("DefaultValueOutput.xlsx");

制限事項

• 行全体または列全体にデフォルト値を設定することができません。
• DioDocs for Excel では、defaultValue に数式を設定した場合、動的配列はサポートしていません。したがって、セルのデフォルト値は、参照の場合は暗黙の交差ポリシー参照し、動的配列の場合は左上のセル値を取得します。
• デフォルト値をコピーすることができません。