要素の表示と非表示
ワークシートの表示と非表示
Excelファイルには1つ以上のワークシートが含まれることがあります。Excelファイルを作成するときには、作業するExcelファイルにワークシートを追加します。Excelファイル内の各ワークシートは、独自のデータや書式設定などを持つため、他のワークシートから独立しています。開発者は時々、Excelファイル内で特定のワークシートを非表示にし、他のワークシートを表示したい場合があります。そのため、Aspose.Cellsは開発者がExcelファイル内のワークシートの表示を制御することを可能にします。
ワークシートの表示を制御する:
Aspose.Cellsは、Excelファイルを表すWorkbookクラスを提供します。Workbookクラスには、Excelファイル内の各ワークシートにアクセスするためのWorksheetCollectionが含まれています。
ワークシートはWorksheetクラスで表されます。Worksheetクラスには、ワークシートを管理するための様々なプロパティやメソッドがあります。ただし、ワークシートの表示の制御には、WorksheetクラスのsetVisibleメソッドを使用することができます。
ワークシートを表示する
開発者は、WorksheetクラスのsetVisibleメソッドにtrueをパラメータとして渡すことで、ワークシートを表示することができます。
ワークシートを非表示にする
開発者は、WorksheetクラスのsetVisibleメソッドにfalseをパラメータとして渡すことで、ワークシートを非表示にすることができます。
例:
以下は、WorksheetクラスのsetVisible(false)メソッドを使用してExcelファイルの最初のワークシートを非表示にする方法を示す完全な例です。
ワークシート - 修改前:
下のスクリーンショットでは、Book1.xls ファイルには Sheet1、 Sheet2、 Sheet3 の3つのワークシートが含まれていることがわかります。
**図: ** どのような変更も加わる前のワークシートビュー
ワークシート - 例のコードを実行後:
Book1.xls ファイルは Workbook クラスを使用して開かれ、その後 Book1.xls ファイルの最初のワークシートが非表示にされます。変更したファイルは output.xls ファイルとして保存され、その視覚的なビューが以下に示されています:
**図: ** 変更後のワークシートビュー
VisibilityTypeの設定
ユーザーはワークシートを特別な方法で非表示にすることもできます。この機能を使用することで、ワークシートを非表示にし、MS Excelのメニューオプションを使用して直接表示する唯一の方法が、コード内でsetVisibilityTypeメソッドのパラメータ値としてVisibilityType.VERY_HIDDENを指定することです(ここで注意する必要がありますが、ユーザーはオブジェクトをMS Excelで直接表示することはできません)。ユーザーはまた、getVisibilityTypeメソッドを使用して、ワークシートがVeryHiddenとしてマークされているかどうかを確認することもできます。
タブの表示または非表示
Microsoft Excelの下部をよく見ると、いくつかのコントロールが表示されます。これには次のものが含まれます:
- シートタブ。
- タブのスクロールボタン。
シートタブはExcelファイル内のワークシートを表します。任意のタブをクリックするとそのワークシートに切り替えることができます。ワークブック内にワークシートが多いほど、シートタブも多く表示されます。Excelファイルに多くのワークシートが含まれている場合は、それらをナビゲートするためのボタンが必要になります。そのため、Microsoft Excelはシートタブのスクロールボタンを提供しています。
シートのタブとタブのスクロールボタン
Aspose.Cellsを使用すると、開発者はExcelファイル内のシートタブとタブのスクロールボタンの表示を制御できます。
タブの表示を制御する: Aspose.Cells は、Microsoft Excel ファイルを表す Workbook クラスを提供します。Workbook クラスは、Excelファイルの管理に広範なプロパティやメソッドを提供します。
タブを非表示にする
Excelファイルのタブを Workbook クラスの getSettings().setShowTabs(false) メソッドを設定して非表示にします。
タブを表示する
Workbook クラスの getSettings().setShowTabs(true) メソッドを使用してタブを表示します。
完全なコード例:
以下は、Excelファイル(book1.xls)を開き、そのタブを非表示にして変更したファイルをoutput.xlsとして保存する完全な例です。
Book1.xlsファイルにタブが含まれていることが以下の図からわかります。例のコードが実行された後、タブが非表示になっていることがoutput.xlsファイルのスクリーンショットから確認できます。
book1.xls: 修正前のExcelファイル
output.xls: 修正後のExcelファイル
行や列の表示と非表示
Excelファイルのすべてのワークシートは、行と列に配置されたセルで構成されています。すべての行と列には、それぞれ固有の値があり、それを使用して識別し、個々のセルを識別します。たとえば、行は1、2、3、4などと番号がつけられ、列はA、B、C、Dなどとアルファベット順に並べられます。行と列の値はヘッダーに表示されます。Aspose.Cellsを使用すると、開発者はこれらの行と列のヘッダーの表示を制御できます。
ワークシートの表示を制御する:
Aspose.Cells は、Microsoft Excel ファイルを表す Workbook クラスを提供します。Workbook クラスには、Excelファイル内の各ワークシートにアクセスできる WorksheetCollection が含まれています。
ワークシートは Worksheet クラスによって表されます。Worksheet クラスは、ワークシートを管理するための広範なプロパティやメソッドを提供します。行と列のヘッダーの表示を制御するには、Worksheet クラスの setRowColumnHeadersVisible メソッドを使用します。
行/列ヘッダーを非表示にする
Worksheet クラスの setRowColumnHeadersVisible(false) メソッドを使用して行や列のヘッダーを非表示にします。
行/列ヘッダーを表示する
Worksheet クラスの setRowColumnHeadersVisible(true) メソッドを使用して行や列のヘッダーを表示します。
以下に、Excelファイルの最初のワークシートの行や列のヘッダーを非表示にする方法を示す完全な例が示されています。
以下のスクリーンショットでは、Book1.xls に Sheet1、Sheet2、Sheet3 の3つのワークシートが含まれていることが示されています。それぞれのワークシートは行や列のヘッダーが表示されています。
Book1.xls: 修正前のワークシート
Book1.xls を Workbook クラスを使用して開き、最初のワークシートの行や列のヘッダーを非表示にしました。修正されたファイルは output.xls として保存されています。
修正後のワークシートビュー
スクロールバーの表示と非表示
スクロールバーは、ファイルの内容を移動するために非常によく使用されます。通常、次の2種類のスクロールバーがあります。
- 垂直スクロールバー
- 水平スクロールバー
Microsoft Excelは、ユーザーがワークシートの内容をスクロールできるように、水平および垂直のスクロールバーを提供しています。Aspose.Cellsを使用すると、Excelファイルの両方のタイプのスクロールバーの表示/非表示を制御することができます。
スクロールバーの表示を制御する:
Aspose.CellsはExcelファイルを表すクラス、Workbookを提供しています。Workbookクラスは、Excelファイルを管理するための幅広いプロパティとメソッドを提供しています。ただし、Excelファイル内のスクロールバーの表示を制御するには、開発者はWorkbookクラスのsetVScrollBarVisibleおよびsetHScrollBarVisibleメソッドを使用することができます。
スクロールバーを非表示にする
WorkbookクラスのsetVScrollBarVisibleまたはsetHScrollBarVisibleメソッドをfalseに設定することで、スクロールバーを非表示にします。
スクロールバーを表示する
setVScrollBarVisibleクラスのsetHScrollBarVisibleメソッドをtrueに設定することで、スクロールバーを表示する。
完全なコード例:
以下は、Excelファイルであるbook1.xlsを開き、両方のスクロールバーを非表示にし、変更されたファイルをoutput.xlsとして保存する完全なコードです。
下のスクリーンショットは、スクロールバーが含まれているBook1.xlsファイルを示しています。変更されたファイルはoutput.xlsファイルとして保存され、下にも表示されています。
Book1.xls: 修正前のExcelファイル
output.xls: 修正後のExcelファイル
グリッド線の表示と非表示
すべてのMicrosoft Excelワークシートには、デフォルトでグリッド線があります。これにより、セルを区切ることができ、特定のセルにデータを入力しやすくなります。グリッド線により、ワークシートをセルの集合として表示し、各セルを簡単に識別できます。
Aspose.Cellsを使用すると、グリッド線の表示を制御することができます。
グリッド線の表示を制御する
Aspose.CellsはMicrosoft Excelファイルを表すWorkbookクラスを提供しています。Workbookクラスには、ファイル内の各ワークシートにアクセスできるWorksheetCollectionが含まれています。
ワークシートはWorksheetクラスで表されます。Worksheetクラスには、ワークシートを管理するための幅広いプロパティとメソッドが含まれています。グリッド線の表示を制御するには、WorksheetクラスのsetGridlinesVisibleメソッドを使用します。
グリッド線を表示する
グリッド線を表示するには、WorksheetクラスのsetGridlinesVisible(true)メソッドを使用します。
グリッド線を非表示にする
グリッド線をWorksheetクラスのsetGridlinesVisible(false)メソッドを使用して非表示にします。
例: 特定のワークシートでグリッド線を非表示にする
以下の例は、Excelファイルの最初のワークシートのグリッド線を非表示にするためのWorksheetクラスのsetGridlinesVisible(false)メソッドの使用方法を示しています。
下のスクリーンショットは、Book1.xlsファイルがSheet1、Sheet2、Sheet3の3つのワークシートを含むことを示しています。これらのすべてのワークシートにはグリッド線があります。
修正前のワークシートビュー
Book1.xlsファイルはWorkbookクラスを使用して開かれ、その後、最初のワークシートのグリッド線が非表示にされます。変更したファイルはoutput.xlsファイルとして保存されます。
修正後のワークシートビュー