セル範囲のセルの背景画像の設定

DioDocs for Excelを使用すると、IRangeインタフェースのBackgroundImageプロパティとBackgroundImageLayoutプロパティを使用して、セル範囲のセルの背景画像とそのレイアウトを設定できます。ルの背景画像は、PDF、HTML、IMGにのみエクスポートでき、.sjs形式で保存した場合はSpreadJSでのみ表示できます。BackgroundImageLayout列挙体を使用すると、背景画像のレイアウトをStretch（デフォルト）、Center、Zoom、またはNoneに設定できます。

DioDocs for Excelでは、セルの背景画像として次の画像形式のみをエクスポートできます。

PNG
JPEG/JPG
ICO
SVG
GIF

次のサンプルコードは、さまざまなレイアウトでセルの背景画像を追加し、ワークブックをPDFにエクスポートする方法を示します。

C#	コードのコピー
// 新しいワークブックを作成します var workbook = new Workbook(); IWorksheet worksheet = workbook.Worksheets[0]; // 画像を読み込みます byte[] imageBytes = File.ReadAllBytes("Chrome_icon.png"); worksheet.Range["A2:E2"].Value = new string[] { "Stretch", "Center", "Zoom", "None", "Default(Stretch)" }; worksheet.Range["A3:E3"].Value = "Chrome"; worksheet.Range["A3:E3"].RowHeightInPixel = 80; worksheet.Range["A3:E3"].ColumnWidthInPixel = 100; // セルの背景画像を追加します worksheet.Range["A3:E3"].BackgroundImage = imageBytes; // イメージレイアウトを設定します worksheet.Range["A3"].BackgroundImageLayout = BackgroundImageLayout.Stretch; worksheet.Range["B3"].BackgroundImageLayout = BackgroundImageLayout.Center; worksheet.Range["C3"].BackgroundImageLayout = BackgroundImageLayout.Zoom; worksheet.Range["D3"].BackgroundImageLayout = BackgroundImageLayout.None; // PDFエクスポートオプションを設定します workbook.ActiveSheet.PageSetup.PrintGridlines = true; workbook.ActiveSheet.PageSetup.PrintHeadings = true; // PDFドキュメントとして保存します workbook.Save("CellBackgroundImage.pdf");

コードのコピー

// 新しいワークブックを作成します
var workbook = new Workbook();

IWorksheet worksheet = workbook.Worksheets[0];

// 画像を読み込みます
byte[] imageBytes = File.ReadAllBytes("Chrome_icon.png");

worksheet.Range["A2:E2"].Value = new string[] { "Stretch", "Center", "Zoom", "None", "Default(Stretch)" };
worksheet.Range["A3:E3"].Value = "Chrome";
worksheet.Range["A3:E3"].RowHeightInPixel = 80;
worksheet.Range["A3:E3"].ColumnWidthInPixel = 100;

// セルの背景画像を追加します
worksheet.Range["A3:E3"].BackgroundImage = imageBytes;

// イメージレイアウトを設定します
worksheet.Range["A3"].BackgroundImageLayout = BackgroundImageLayout.Stretch;
worksheet.Range["B3"].BackgroundImageLayout = BackgroundImageLayout.Center;
worksheet.Range["C3"].BackgroundImageLayout = BackgroundImageLayout.Zoom;
worksheet.Range["D3"].BackgroundImageLayout = BackgroundImageLayout.None;

// PDFエクスポートオプションを設定します
workbook.ActiveSheet.PageSetup.PrintGridlines = true;
workbook.ActiveSheet.PageSetup.PrintHeadings = true;

// PDFドキュメントとして保存します
workbook.Save("CellBackgroundImage.pdf");

制限事項

DioDocs for Excel は背景画像を Excel に保存することをサポートしていないため、Excel で表示することはできません。