バージョン

動的に作成された TaskPane ツールバーへのツールの追加（パート 2）

このトピックでは、TaskPaneTool を動的に作成して、その TaskPaneTool にツールを追加する方法について説明します。このトピックは、 「TaskPane ツールバーの動的な作成（パート 1）」の続きです。

UltraTaskPaneToolbar を作成したら、次に TaskPaneTools を追加します。

Visual Basic の場合：

' 新しい TaskPaneTool を作成します。
Dim myTaskPaneTool1 As New TaskPaneTool("myTaskPaneTool1")
' TaskPaneTool のキャプションを設定します。
myTaskPaneTool1.SharedProps.Caption = "myTaskPaneTool1"
' TaskPaneTool を UltraToolbarsManager の Tools コレクションに追加します。
myToolbarManager.Tools.Add(myTaskPaneTool1)
' TaskPaneTool を TaskPaneToolbar に追加します。
myTaskPaneToolbar.Tools.AddRange(New ToolBase() {myTaskPaneTool1})

C# の場合：

// 新しい TaskPaneTool を作成します。
TaskPaneTool myTaskPaneTool1 = new TaskPaneTool("myTaskPaneTool1");
// TaskPaneTool のキャプションを設定します。
myTaskPaneTool1.SharedProps.Caption = "myTaskPaneTool1";
// TaskPaneTool を UltraToolbarsManager の Tools コレクションに追加します。
myToolbarManager.Tools.Add(myTaskPaneTool1);
// TaskPaneTool を TaskPaneToolbar に追加します。
myTaskPaneToolbar.Tools.AddRange(new ToolBase[] { myTaskPaneTool1});

  1. コードを使用して基本的な TaskPaneTool を設定し、それを UltraTaskPaneToolbar に追加する手順はこれですべてです。

  2. これでコントロールを TaskPaneTool に追加する準備ができました。次に、コントロールを TaskPaneTool に追加する方法を説明するため、シンプルな Panel コントロールを TaskPaneTool に追加します。

Visual Basic の場合：

' TaskPaneTool に配置する一般的なコントロールを作成します。
Dim myPanel As New Panel
' TaskPaneTool でホストするコントロールを設定します。
myTaskPaneTool1.Control = myPanel
' 選択状態にする TaskPaneTool を設定します。
myTaskPaneToolbar.SelectedTaskPaneTool = myTaskPaneTool1

C# の場合：

// TaskPaneTool に配置する一般的なコントロールを作成します。
System.Windows.Forms.Panel myPanel = new Panel();
// TaskPaneTool でホストするコントロールを設定します。
myTaskPaneTool1.Control = myPanel;
// 選択状態にする TaskPaneTool を設定します。
myTaskPaneToolbar.SelectedTaskPaneTool = myTaskPaneTool1;

  1. プロジェクトをビルドして実行すると、次のように右端にドッキングした TaskPaneToolbar が表示されます。これには、Panel コントロールをホストしている TaskPaneTool が含まれます。

WinToolbarsManager Working with Dynamically Created TaskPane Toolbars 01.png
Note

注： TaskPaneTool に追加できるコントロールは 1 つだけなので、複数のコントロールを追加したい場合は、それらをパネルまたはグループボックスに配置してから、それを TaskPaneTool に追加するコントロールとして選択します。たとえば、複数のボタンとテキストボックスが必要な場合は、それらすべてのコントロールを中に配置したパネルまたはグループボックスを作成してから、そのパネルまたはグループボックスを TaskPaneTool のコントロールとして選択します。