セルの書式設定

このトピックでは、セルの書式設定について詳しく説明します。

Aspose.Cells.GridWebコントロールのスタイルダイアログを使用してGUIモードでのセルの書式設定をカバーしています。また、プログラムでセルの書式を設定する方法も示しています。フォント、罫線、および数値書式などのさまざまな書式設定が例を交えて説明されています。

スタイルダイアログを使用してセルの書式を設定する

セルの書式設定はプログラムで行うこともできますが、Aspose.Cells.GridWebコントロールでセルの書式設定をWYSIWYGな方法で行うには、スタイルダイアログを使用するのが最も簡単です。

スタイルダイアログの使用方法： セルの範囲を選択して右クリックし、セルの書式設定を選択します。

セルの書式設定を選択

スタイルダイアログが表示されます。

セルの書式を設定するためにスタイルダイアログが使用されます

スタイルダイアログを使用すると、ユーザーはフォントや罫線の設定をカスタマイズしてセルの書式を設定できます。

フォント設定のカスタマイズ

スタイルダイアログを使用して、以下のフォント設定をカスタマイズできます:

• フォント名、リストから希望のフォントを選択します。
• フォントスタイル、太字、斜体などのフォントスタイルを適用します。
• フォントサイズ、ポイントでフォントサイズを選択します。
• 下線、テキストに下線を引きます。
• 取り消し線、テキストに取り消し線の効果を適用します。
• 水平配置、水平配置を選択します。
• 垂直配置、垂直配置を選択します。
• フォントの色、フォントの色を選択します。
• 背景、背景の色を選択します。

選択したフォント設定を小さなプレビューエリアで確認できます。

カスタマイズされたフォント設定

境界線設定のカスタマイズ

スタイルダイアログで境界線設定をカスタマイズすることで、セルの周囲に境界線を描画することも可能です。

境界線に関連するオプションを表示するには: スタイルダイアログで境界線をクリックします。 境界線に関連するオプションが表示されます。

スタイルダイアログ内の境界線オプション

スタイルダイアログから以下の境界線オプションを選択できます:

• 境界線スタイル、実線、点線などの境界線スタイルを選択します。
• 境界線の幅、ピクセル単位で境界線の幅を選択します。
• 境界線の色、線の色を選択します。
• 境界線、境界線の番号付けと配置を選択します。

カスタマイズされた境界線設定

設定の適用

変更を適用するには、スタイルダイアログでOKをクリックします。

フォントおよび境界線設定が適用されました

APIを使用したセルの書式設定

Aspose.Cells.GridWeb APIを使用して、プログラムでセルの書式設定も可能です。各セルにはStyleプロパティがあり、これはGridTableItemStyleオブジェクトを表します。フォントおよび境界線設定をカスタマイズするには、Styleプロパティを使用します。

フォントの設定

プログラムでフォント設定をカスタマイズするには:

1. Web フォームに Aspose.Cells.GridWeb コントロールを追加します。
2. ワークシートにアクセスします。
3. フォーマットするセルにアクセスします。
4. セルのスタイルにアクセスします。
5. フォントサイズをポイントで設定します。
6. フォントスタイルを設定します。
7. 前景色と背景色を設定します。
8. 水平および垂直の配置を設定します。
9. スタイルをセルに戻します。

出力: A1に表示されるカスタマイズされたフォント設定

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active and resize first row and column
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
sheet.Cells.Clear();
sheet.Cells.SetColumnWidth(0, 50);
sheet.Cells.SetRowHeight(0, 40);

// Accessing a specific cell of the worksheet
GridCell cell = sheet.Cells["A1"];

// Inserting a value in cell A1
cell.PutValue("Aspose.Cells.GridWeb");
           
var style = cell.Style;

// Setting font, color and alignment of cell
style.Font.Size = new FontUnit("12pt");
style.Font.Bold = true;
style.ForeColor = Color.Blue;
style.BackColor = Color.Aqua;
style.HorizontalAlign = HorizontalAlign.Center;                        

// Set the cell style
cell.CopyStyle(style);
sheet.AutoFitColumn(0);

境界線の設定

境界線は個々のセルまたは範囲に適用できます。

個々のセル

個々のセルの境界線を設定するには:

1. Web フォームに Aspose.Cells.GridWeb コントロールを追加します。
2. ワークシートにアクセスします。
3. フォーマットするセルにアクセスします。
4. セルのスタイルオブジェクトにアクセスします。
5. 境界スタイルを設定します。
6. 境界の幅をピクセルで設定します。
7. 境界線の色を設定します。
8. セルにスタイルを設定します。

個々のセルのカスタマイズされた境界設定

セルのStyle.TopBorderStyle、Style.BottomBorderStyle、Style.LeftBorderStyle、Style.RightBorderStyleプロパティを使用して、各境界線に異なるスタイルを設定することができます。

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active and resize first row and column
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];
sheet.Cells.Clear();
sheet.Cells.SetColumnWidth(0, 50);
sheet.Cells.SetRowHeight(0, 40);

// Accessing a specific cell of the worksheet
GridCell cell = sheet.Cells["A1"];

var style = cell.Style;

// Setting the border style, width and color
style.BorderStyle = BorderStyle.Solid;
style.BorderWidth = new Unit(2, UnitType.Pixel);
style.BorderColor = Color.Blue;
            
// Set the cell style
cell.CopyStyle(style);

セルの範囲

セルの範囲に境界線を設定するには:

1. Web フォームに Aspose.Cells.GridWeb コントロールを追加します
2. 希望のワークシートにアクセスします
3. WebBorderStyle クラスのオブジェクトをインスタンス化します
4. 境界線のスタイルをソリッドまたはダッシュなどに設定します
5. 境界線の幅をピクセル単位で設定します
6. 境界線の色を設定します
7. WebBorderStyle オブジェクトに格納された境界線の設定を特定のセル範囲に適用します

カスタマイズされた境界線設定のセル範囲

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

sheet.Cells.Clear();

// Creating an instance of WebBorderStyle
WebBorderStyle bstyle = new WebBorderStyle();

// Setting the border style, width and color
bstyle.BorderStyle = BorderStyle.Double;
bstyle.BorderWidth = new Unit(3, UnitType.Pixel);
bstyle.BorderColor = Color.Blue;

// Applying the instance of WebBorderStyle on a specified range of cells
sheet.Cells.SetBorders(1, 1, 5, 4, SetBorderPosition.Cross, bstyle);

数値形式の設定

Aspose.Cells.GridWeb は数値形式の設定をサポートしています。59 個の組み込み数値形式があります。これらを表示するには、サポートされている数値形式の一覧 を参照してください。

すべての組み込み数値形式は NumberType 列挙型に含まれています。組み込みの数値形式を使用するには、セルのオブジェクトの SetNumberType メソッドを使用して、NumberType 列挙型から数値形式を設定します。

カスタム数値形式を設定するには、セルの SetCustom メソッドを使用します。

B1 と B2 に適用された数値形式設定

// For complete examples and data files, please go to https://github.com/aspose-cells/Aspose.Cells-for-.NET
// Accessing the reference of the worksheet that is currently active
GridWorksheet sheet = GridWeb1.WorkSheets[GridWeb1.ActiveSheetIndex];

sheet.Cells.Clear();
            
sheet.Cells.SetColumnWidth(0, 50);
sheet.Cells.SetRowHeight(0, 40);

// Putting values to cells
sheet.Cells["A1"].PutValue("Currency1 Number Format");
sheet.Cells["A2"].PutValue("Custom Number Format");
sheet.Cells["B1"].PutValue(7800);
sheet.Cells["B2"].PutValue(2500);

// Setting the number format of "B1" cell to Currency1
sheet.Cells["B1"].SetNumberType((int)NumberType.Currency1);
        
// Setting the custom number format of "B2" cell
sheet.Cells["B2"].SetCustom("#,##0.0000");