コントロールの管理
紹介
開発者は、テキストボックス、チェックボックス、ラジオボタン、コンボボックス、ラベル、ボタン、線、長方形、弧、楕円、スピナー、スクロールバー、グループボックスなどのさまざまな描画オブジェクトを追加できます。Aspose.Cells for Python via .NET は、すべての描画オブジェクトを含む Aspose.Cells.Drawing 名前空間を提供します。ただし、一部の描画オブジェクトや図形はまだサポートされていません。Microsoft Excel を使用してこれらの描画オブジェクトをデザイナーのスプレッドシートで作成し、その後、そのデザイナーのスプレッドシートを Aspose.Cells にインポートしてください。Aspose.Cells for Python via .NET は、これらの描画オブジェクトをデザイナーのスプレッドシートからロードし、生成されたファイルに書き込むことを可能にします。
ワークシートにテキストボックスコントロールを追加
レポート内の重要な情報を強調する一つの方法は、テキストボックスを使用することです。例えば、会社名をハイライトするためや、売上高が最も高い地域を示すためなどです。Aspose.Cells for Python via .NET は、コレクションに新しいテキストボックスを追加するために TextBoxCollection クラスを提供します。もう一つのクラス TextBox は、すべての設定タイプを定義するためのテキストボックスを表します。重要なメンバーがいくつかあります：
- text_frameプロパティは、テキストボックスの内容を調整するために使用されるMsoTextFrameオブジェクトを返します。
- placementプロパティは配置タイプを指定します。
- fontプロパティはフォント属性を指定します。
- add_hyperlinkメソッドは、テキストボックスにハイパーリンクを追加します。
- fill_formatプロパティは、テキストボックスの塗りつぶし形式を設定するために使用されるMsoFillFormatオブジェクトを返します。
- line_formatプロパティは、テキストボックスのラインのスタイルと太さを通常設定するために使用されるMsoLineFormatオブジェクトを返します。
- textプロパティは、テキストボックスの入力テキストを指定します。
次の例では、ブックの最初のワークシートに2つのテキストボックスを作成します。最初のテキストボックスはさまざまなフォーマット設定で整備されています。2番目はシンプルなものです。
デザイナースプレッドシート内のテキストボックスコントロールの操作
Aspose.Cells for Python via .NET は、デザイナーのワークシート内のテキストボックスにアクセスし、それらを操作することも可能です。Worksheet.TextBoxes プロパティを使用して、シート内のテキストボックスのコレクションを取得します。
次の例では、上記の例で作成したMicrosoft Excelファイルを使用しています。2つのテキストボックスのテキストを取得し、2番目のテキストボックスのテキストを変更してファイルを保存します。
ワークシートにチェックボックスコントロールを追加する
チェックボックスは、true または false、はい または いいえなどの二つの選択肢の中からユーザーに選ばせる方法を提供したい場合に便利です。Aspose.Cells for Python via .NET では、ワークシート内にチェックボックスを使用できます。例えば、特定の買収について考慮するかどうかを示す財務予測ワークシートを作成した場合、ワークシートの上部にチェックボックスを配置したいことがあります。その後、そのチェックボックスの状態を別のセルにリンクさせ、チェックボックスが選択されている場合はセルの値が True に、選択されていない場合は False になるように設定できます。
Microsoft Excel の使用
ワークシートにチェックボックスコントロールを配置するには、次の手順に従います。
- フォームツールバーが表示されていることを確認します。
- フォームツールバーのチェックボックスツールをクリックします。
- ワークシートエリアで、チェックボックスとチェックボックスの横に表示されるラベルを定義するためにクリックしてドラッグします。
- チェックボックスが配置されたら、マウスカーソルをラベル領域に移動してラベルを変更します。
- セルリンクフィールドで、このチェックボックスをリンクするセルのアドレスを指定します。
- OK をクリックします。
Aspose.Cells for Python via .NETを使用して
Aspose.Cells for Python via .NET は、新しいチェックボックスをコレクションに追加するために CheckBoxCollection クラスを提供します。もう一つのクラス Aspose.Cells.Drawing.CheckBox はチェックボックスを表します。重要なメンバーがいくつかあります：
- linked_cellプロパティは、チェックボックスにリンクされるセルを指定します。
- textプロパティは、チェックボックスに関連付けられたテキスト文字列を指定します。これはチェックボックスのラベルです。
- valueプロパティは、チェックボックスが選択されているかどうかを指定します。
次の例では、ワークシートにチェックボックスを追加する方法を示しています。
ワークシートにラジオボタンコントロールを追加する
ラジオボタン、またはオプションボタンは、円形のボックスからなるコントロールです。ユーザーはラウンドボックスを選択することで決定を行います。ラジオボタンは通常、他のラジオボタンに伴って表示され、グループとして振る舞います。ユーザーは1つのボタンのみを選択することで、どのボタンが有効か決定します。ユーザーが1つのボタンをクリックすると、それは選択されます。グループ内の1つのボタンが選択されると、同じグループのボタンは空になります。
Microsoft Excel の使用
ワークシートにラジオボタンコントロールを配置するには、次の手順に従います。
- フォーム ツールバーが表示されていることを確認します。
- オプションボタンツールをクリックします。
- ワークシートで、オプションボタンとオプションボタンの横に表示されるラベルを定義するためにクリックしてドラッグします。
- ワークシートにラジオボタンを配置したら、マウスカーソルをラベル領域に移動してラベルを変更します。
- セルリンクフィールドで、このラジオボタンがリンクされるセルのアドレスを指定します。
- OK をクリックします。
Aspose.Cells for Python via .NETを使用して
Aspose.Cells.Drawing.ShapeCollectionクラスには、ワークシートにラジオボタンコントロールを追加するために使用されるadd_radio_buttonというメソッドがあります。このメソッドはAspose.Cells.Drawing.RadioButtonオブジェクトを返します。また、Aspose.Cells.Drawing.RadioButtonクラスもあります。
- linked_cellプロパティは、ラジオボタンにリンクされるセルを指定します。
- textプロパティは、ラジオボタンに関連付けられたテキスト文字列を指定します。これはラジオボタンのラベルです。
- is_checkedプロパティは、ラジオボタンが選択されているかどうかを指定します。
- fill_formatプロパティは、ラジオボタンの塗りつぶし形式を指定します。
- line_formatプロパティは、オプションボタンの線の形式スタイルを指定します。
次の例では、ワークシートにラジオボタンを追加する方法を示しています。例では、3つの年齢グループを表すラジオボタンが追加されています。
ワークシートにコンボボックスコントロールを追加する
データの入力を容易にするか、定義した項目にエントリを制限するためには、ワークシートの他のセルからコンパイルされる有効なエントリのコンボボックス、またはドロップダウンリストを作成できます。セルのドロップダウンリストを作成すると、そのセルの隣に矢印が表示されます。そのセルに情報を入力するには、矢印をクリックし、その後、欲しいエントリをクリックします。
Microsoft Excel の使用
ワークシートにコンボボックスコントロールを配置するには、次の手順に従います：
- フォーム ツールバーが表示されていることを確認します。
- コンボボックス ツールをクリックします。
- ワークシートエリアで、コンボボックスを保持する四角形を定義するためにクリックしてドラッグします。
- コンボボックスがワークシートに配置されたら、コントロールを右クリックして コントロールの書式設定 をクリックし、入力範囲を指定します。
- セルリンク フィールドで、このコンボボックスをリンクするセルのアドレスを指定します。
- OK をクリックします。
Aspose.Cells for Python via .NETを使用して
クラス Aspose.Cells.Drawing.ShapeCollection は add_combo_box という名前のメソッドを提供し、これはワークシートにコンボボックスコントロールを追加するために使用されます。このメソッドは Aspose.Cells.Drawing.ComboBox オブジェクトを返します。Aspose.Cells.Drawing.ComboBox クラスはコンボボックスを表します。いくつかの重要なメンバを持っています：
- linked_cell プロパティはコンボボックスにリンクされたセルを指定します。
- input_range プロパティはコンボボックスを埋めるために使用されるワークシートのセル範囲を指定します。
- drop_down_lines プロパティはドロップダウン部分に表示されるリスト行の数を指定します。
- shadow プロパティはコンボボックスが 3D シェーディングを持っているかどうかを示します。
次の例は、ワークシートにコンボボックスを追加する方法を示しています。
ワークシートにラベルコントロールを追加する
ラベルは、スプレッドシートの内容についてユーザーに情報を提供する手段です。Aspose.Cells for Python via .NET では、ワークシート内のラベルを追加・操作することが可能です。ShapeCollection クラスは、add_label というメソッド提供し、これを使用してラベルコントロールをワークシートに追加します。このメソッドは Label オブジェクトを返します。Label クラスは、ワークシート内のラベルを表します。重要なメンバーがいくつかあります。
次の例は、ワークシートにラベルを追加する方法を示しています。
ワークシートにリストボックスコントロールを追加する
リストボックスコントロールは、単一または複数のアイテム選択を可能にするリストコントロールを作成します。
Microsoft Excel の使用
ワークシートにリストボックスコントロールを配置するには：
- フォーム ツールバーが表示されていることを確認します。
- リストボックス ツールをクリックします。
- ワークシートエリアで、リストボックスを保持する四角形を定義するためにクリックしてドラッグします。
- リストボックスがワークシートに配置されたら、コントロールを右クリックして コントロールの書式設定 をクリックし、入力範囲を指定します。
- セルリンク フィールドで、このリストボックスをリンクするセルのアドレスを指定し、選択タイプ（単一、複数、拡張）属性を設定します。
- OK をクリックします。
Aspose.Cells for Python via .NETを使用して
クラス ShapeCollection は、ワークシートにリストボックスコントロールを追加するために使用される add_list_box という名前のメソッドを提供します。このメソッドは Aspose.Cells.Drawing.ListBox オブジェクトを返します。ListBox クラスはリストボックスを表します。いくつかの重要なメンバを持っています：
- linked_cell メソッドはリストボックスにリンクされたセルを指定します。
- input_range メソッドはリストボックスを埋めるために使用されるワークシートのセル範囲を指定します。
- selection_type メソッドはリストボックスの選択モードを指定します。
- shadow メソッドはリストボックスに3Dシェーディングがあるかどうかを示します。
次の例は、ワークシートにリストボックスを追加する方法を示しています。
ボタンコントロールをワークシートに追加する
ボタンは何かアクションを行うために便利です。時には、ボタンにVBAマクロを割り当てたり、Webページを開くためのハイパーリンクを割り当てることも有用です。
Microsoft Excel の使用
ボタンコントロールをワークシートに配置するには:
- フォーム ツールバーが表示されていることを確認します。
- ボタン ツールをクリックします。
- ワークシート領域でクリックしてドラッグして、ボタンを配置する矩形を定義します。
- リストボックスがワークシートに配置されたら、コントロールを右クリックして フォーマットコントロール を選択し、VBAマクロを指定し、フォント、配置、サイズ、余白などに関連する属性を設定します。
- OK をクリックします。
Aspose.Cells for Python via .NETを使用して
ShapeCollection クラスは、ボタンコントロールをワークシートに追加するための add_button という名前のメソッドを提供します。このメソッドは Aspose.Cells.Drawing.Button オブジェクトを返します。クラス Aspose.Cells.Drawing.Button はボタンを表します。いくつかの重要なメンバーがあります:
- text プロパティはボタンのキャプションを指定します。
- font プロパティはボタンコントロールのラベルのフォント属性を指定します。
- placement プロパティはボタンがワークシートのセルにアタッチされる方法を指定します。
- add_hyperlink プロパティはボタンコントロールにハイパーリンクを追加します。ボタンをクリックすると関連するURLに移動します。
次の例は、ワークシートにボタンを追加する方法を示しています。
ワークシートにラインコントロールを追加する
Microsoft Excel の使用
- 描画 ツールバーで オートシェイプ をクリックし、ライン を指して、希望のラインスタイルを選択します。
- ドラッグしてラインを描きます。
- 次のいずれかを行います。
- ラインを開始点から15度の角度で制限するには、ドラッグしながら SHIFT キーを押します。
- 最初の端点から異なる方向にラインを長くするには、ドラッグしながら CTRL キーを押します。
Aspose.Cells for Python via .NETを使用して
ShapeCollection クラスは、ワークシートにラインシェイプを追加するために使用される add_line という名前のメソッドを提供します。このメソッドは LineShape オブジェクトを返します。クラス LineShape はラインを表します。いくつかの重要なメンバーがあります:
- line_format メソッドはラインのフォーマットを指定します。
- placement メソッドはラインがワークシートのセルにアタッチされる方法を指定します。
次の例は、ワークシートにラインを追加する方法を示しています。異なるスタイルで3つのラインが作成されます。
ラインに矢印を追加する
Aspose.Cells for Python via .NET は、矢印線を描画することも可能です。線に矢じりを追加したり、線の書式を設定したりすることができます。例えば、線の色を変更したり、線の太さやスタイルを指定したりできます。
次の例は、ラインに矢印を追加する方法を示しています。
ワークシートに長方形コントロールを追加する
Aspose.Cells for Python via .NET は、ワークシートに長方形の図形を描画することを可能にします。長方形、正方形などを作成でき、塗りつぶし色や境界線の色のフォーマットも可能です。例えば、長方形の色を変更したり、シェーディング色を設定したり、必要に応じて太さやスタイルを指定できます。
Microsoft Excel の使用
- 描画ツールバーで、長方形をクリックします。
- 長方形を描画するには、ドラッグします。
- 次のいずれかを行います。
- 長方形を開始点から正方形に描画するには、ドラッグしながらSHIFTキーを押し続けます。
- 長方形を中心点から描画するには、ドラッグしながらCTRLキーを押し続けます。
Aspose.Cells for Python via .NETを使用して
クラスShapeCollectionには、ワークシートに長方形を追加するためのadd_rectangleという名前のメソッドがあります。このメソッドはAspose.Cells.Drawing.RectangleShapeオブジェクトを返します。クラスAspose.Cells.Drawing.RectangleShapeは長方形を表します。いくつか重要なメンバーがあります。
- line_formatプロパティは長方形の線の書式属性を指定します。
- placementプロパティはPlacementTypeを指定し、長方形がワークシートのセルにアタッチされる方法を示します。
- fill_formatプロパティは長方形の塗りつぶしの書式スタイルを指定します。
次の例は、ワークシートに長方形を追加する方法を示しています。
ワークシートに円弧コントロールを追加する
Aspose.Cells for Python via .NET は、楕円の図形を描画することもできます。シンプルな楕円や塗りつぶし楕円を作成し、塗りつぶし色や境界線の色をフォーマットすることができます。
Microsoft Excel の使用
- 図形の自動スタイルで、円弧をクリックします。
- 円弧を描画するには、ドラッグします。
Aspose.Cells for Python via .NETを使用して
クラスShapeCollectionには、ワークシートに円弧形状を追加するためのadd_arcという名前のメソッドがあります。このメソッドはAspose.Cells.Drawing.ArcShapeオブジェクトを返します。クラスAspose.Cells.Drawing.ArcShapeは円弧を表します。いくつか重要なメンバーがあります。
- line_formatプロパティは円弧形状の線の書式属性を指定します。
- placementプロパティはPlacementTypeを指定し、円弧がワークシートのセルにアタッチされる方法を示します。
- fill_formatプロパティは形状の塗りつぶし形式スタイルを指定します。
- lower_right_rowプロパティは右下の行インデックスを指定します。
- lower_right_columnプロパティは右下の列インデックスを指定します。
次の例は、ワークシートに円弧形状を追加する方法を示しています。この例では、塗りつぶしの円弧形状とシンプルな円弧形状の2つを作成します。
ワークシートに楕円コントロールを追加する
Aspose.Cells for Python via .NET は、ワークシートに楕円形を描くことも可能です。シンプルまたは塗りつぶしの楕円を作成し、塗りつぶし色や境界線の色を設定できます。
Microsoft Excel の使用
- 図形ツールバーで、楕円をクリックします。
- 楕円を描画するには、ドラッグします。
- 以下のいずれか、または両方を行います。
- 楕円を開始点から円として描画するには、ドラッグしながらSHIFTキーを押し続けます。
- 楕円を中心点から描画するには、ドラッグしながらCTRLキーを押し続けます。
Aspose.Cells for Python via .NETを使用して
クラスShapeCollectionは、ワークシートに楕円形を追加するために使用されるadd_ovalというメソッドを提供します。このメソッドはAspose.Cells.Drawing.Ovalオブジェクトを返します。クラスAspose.Cells.Drawing.Ovalは楕円形を表し、いくつかの重要なメンバーがあります。
- line_formatプロパティは楕円形の線形式属性を指定します。
- placementプロパティはワークシート内のセルに楕円形を接続する方法を指定します。
- fill_formatプロパティは形状の塗りつぶし形式スタイルを指定します。
- lower_right_rowプロパティは右下の行インデックスを指定します。
- lower_right_columnプロパティは右下の列インデックスを指定します。
次の例は、ワークシートに楕円形を追加する方法を示しています。この例では、塗りつぶしの楕円形と単純な円形の2つの楕円形を作成します。
ワークシートにスピンボックスコントロールを追加
スピンボックスは、上矢印と下矢印のついたボタン（スピンボタン）に付属したテキストボックスです。クリックすることで値を段階的に増減させることができます。スピンボックスを使用すると、財務モデルに入力された値の変化が、モデルの出力にどのように影響するかを見ることができます。特定の入力セルにスピンボタンを結びつけることが可能です。スピンボタンの上矢印または下矢印をクリックすると、対象の入力セルの整数値が増加または減少します。Aspose.Cells for Python via .NET では、ワークシートにスピナーを作成できます。
Microsoft Excel の使用
ワークシートにスピンボックスコントロールを配置するには:
- フォームツールバーが表示されていることを確認します。
- スピンボックスツールをクリックします。
- ワークシート領域で、スピンボックスを保持する矩形を定義するためにクリックしてドラッグします。
- スピンボックスをワークシートに配置したら、コントロールを右クリックして フォーマットコントロール をクリックし、最大値、最小値、増分値を指定します。
- セルリンク フィールドに、このスピンボックスをリンクするセルのアドレスを指定します。
- OK をクリックします。
Aspose.Cells for Python via .NETを使用して
クラスShapeCollectionは、ワークシートにスピンボックスコントロールを追加するために使用されるadd_spinnerというメソッドを提供します。このメソッドはAspose.Cells.Drawing.Spinnerオブジェクトを返します。クラスAspose.Cells.Drawing.Spinnerはスピンボックスを表し、いくつかの重要なメンバーがあります。
- linked_cellプロパティは、スピンボックスにリンクされたセルを指定します。
- maxプロパティは、スピンボックス範囲の最大値を指定します。
- minプロパティは、スピンボックス範囲の最小値を指定します。
- incremental_changeプロパティは、スピンボックスが1行スクロールされる値の量を指定します。
- shadowプロパティは、スピンボックスに3Dシェーディングがあるかどうかを示します。
- current_valueプロパティは、スピンボックスの現在の値を指定します。
次の例は、ワークシートにスピンボックスを追加する方法を示しています。
ワークシートにスクロールバーコントロールを追加する
スクロールバーコントロールは、ワークシート上のデータを選択するのを支援するために使用され、スピンボックスコントロールと同様の方法でワークシートに追加できます。ワークシートにコントロールを追加し、セルにリンクすることで、コントロールの現在の位置の数値を返すことができます。
Microsoft Excel の使用
- Excel 2003およびそれ以前のバージョンでは、フォームツールバーの スクロールバー ボタンをクリックし、高さでセルB2:B6をカバーし、列の1/4程度の幅でスクロールバーを作成します。
- Excel 2007では、開発タブをクリックし、挿入をクリックし、フォームコントロールセクションでスクロールバーをクリックします。
- スクロールバーを右クリックし、フォーマットコントロールをクリックします。
- 次の情報を入力し、OKをクリックします。
- 現在の値ボックスに1と入力します。
- 最小値ボックスに1と入力します。この値は、スクロールバーの上部をリスト内の最初のアイテムに制限します。
- 最大値ボックスに20と入力します。この数はリスト内のエントリの最大数を指定します。
- 増分変更ボックスに1と入力します。この値は、スクロールバーが現在の値を増分変更する数を制御します。
- ページ変更ボックスに5と入力します。このエントリは、スクロールバー内のスクロールボックスのいずれかの側をクリックした場合に、現在の値が増分変更される量を制御します。
- リストで選択されたアイテムに応じてセルG1に数値を入力する場合、セルリンクボックスにG1と入力します。
- スクロールバーが選択されていないことを確認するために、どこかのセルをクリックします。
スクロールバーの上または下のコントロールをクリックすると、セルG1はスクロールバーの現在の値に増分変更を足したり引いたりした数値に更新されます。
Aspose.Cells for Python via .NETを使用して
ShapeCollectionクラスは、ワークシートにスクロールバーコントロールを追加するために使用されるadd_scroll_barというメソッドを提供します。このメソッドはAspose.Cells.Drawing.ScrollBarオブジェクトを返します。Aspose.Cells.Drawing.ScrollBarクラスはスクロールバーを表します。いくつかの重要なメンバーがあります:
- linked_cellプロパティは、スクロールバーにリンクされたセルを指定します。
- maxプロパティは、スクロールバー範囲の最大値を指定します。
- minプロパティは、スクロールバー範囲の最小値を指定します。
- incremental_changeプロパティは、スクロールバーが1行スクロールされたときの値の量を指定します。
- shadowプロパティは、スクロールバーに3Dの影があるかどうかを示します。
- current_valueプロパティは、スクロールバーの現在の値を指定します。
- page_changeプロパティは、スクロールバー内のスクロールボックスのいずれかの側をクリックした場合に、現在の値が増分変更される量を指定します。
以下の例は、ワークシートにスクロールバーを追加する方法を示しています。
ワークシートでグループコントロールにグループボックスコントロールを追加する
特定のグループに所属するラジオボタンやその他のコントロールを実装する必要がある場合は、グループボックスまたは長方形コントロールを含めることによって実装できます。これらの2つのオブジェクトのいずれかがグループのデリミタとして機能します。これらの形を追加した後は、2つ以上のラジオボタンやその他のグループオブジェクトを追加できます。
Microsoft Excel の使用
ワークシートにグループボックスコントロールを配置し、その中にコントロールを配置するには:
- フォームを開始するには、メインメニューで表示をクリックし、ツールバーとフォームをクリックします。
- フォームツールバーで、グループボックスをクリックし、ワークシート上に長方形を描きます。
- ボックスのキャプション文字列を入力します。
- フォームツールバーで、オプションボタンをクリックし、グループボックス内のキャプション文字列の真下をクリックします。
- 再度フォームツールバーで、オプションボタンをクリックし、前のラジオボタンの下にグループボックス内をクリックします。
- もう一度フォームツールバーで、オプションボタンをクリックし、前のラジオボタンの下にグループボックス内をクリックします。
Aspose.Cells for Python via .NETを使用して
ShapeCollectionクラスは、ワークシートにグループボックスを追加し、コントロールをグループ化するためのadd_group_boxというメソッドを提供します。このメソッドはAspose.Cells.Drawing.GroupBoxオブジェクトを返します。また、groupクラスのShapeCollectionメソッドは、形をグループ化し、Shape配列をパラメータとして取り、GroupShapeオブジェクトを返します。Aspose.Cells.Drawing.GroupBoxクラスはグループボックスを表します。いくつかの重要なメンバーがあります:
以下の例は、ワークシートにグループボックスを追加し、コントロールをグループ化する方法を示しています。