ToolBar.ImageList プロパティ

.NET Framework クラス ライブラリ リファレンス

ToolBar.ImageList プロパティ

ツール バー ボタン コントロールで使用できるイメージのコレクションを取得または設定します。

名前空間: System.Windows.Forms
アセンブリ: System.Windows.Forms (system.windows.forms.dll 内)
構文

Visual Basic (宣言)

Public Property ImageList As
 ImageList

Visual Basic (使用法)

Dim instance As ToolBar
Dim value As ImageList

value = instance.ImageList

instance.ImageList = value

C#

public ImageList ImageList { get; set;
 }

C++

public:
property ImageList^ ImageList {
    ImageList^ get ();
    void set (ImageList^ value);
}

J#

/** @property */
public ImageList get_ImageList ()

/** @property */
public void set_ImageList (ImageList value)

JScript

public function get ImageList
 () : ImageList

public function set ImageList
 (value : ImageList)

プロパティ値
ToolBarButton コントロールで使用できるイメージを格納する ImageList。既定値は null 参照 (Visual Basic では Nothing) です。

解説

ImageList を作成し、そのオブジェクトを ImageList プロパティに割り当てた場合、イメージのインデックス値をツール バー ボタンの ImageIndex プロパティに代入することによって、イメージをコレクションから ToolBarButton コントロールに割り当てることができます。

使用例

ToolBar コントロールを作成し、その共通のプロパティの一部を設定し、これを Form に追加するコード例を次に示します。デリゲートは、ButtonClick イベントおよび ButtonDropDown イベントにも追加されます。この例は、toolBar1 という名前の ToolBar と imageList1 という名前の ImageList が宣言されていることを前提にしています。

Visual Basic

Private Sub AddToolBar()
   ' Add a toolbar and set some of its properties.
   toolBar1 = New ToolBar()
   toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat
   toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None
   toolBar1.Buttons.Add(Me.toolBarButton1)
   toolBar1.ButtonSize = New System.Drawing.Size(24, 24)
   toolBar1.Divider = True
   toolBar1.DropDownArrows = True
   toolBar1.ImageList = Me.imageList1
   toolBar1.ShowToolTips = True
   toolBar1.Size = New System.Drawing.Size(292, 25)
   toolBar1.TabIndex = 0
   toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right
   toolBar1.Wrappable = False

   ' Add handlers for the ButtonClick and ButtonDropDown events.
   AddHandler toolBar1.ButtonDropDown, AddressOf
 toolBar1_ButtonDropDown
   AddHandler toolBar1.ButtonClick, AddressOf
 toolBar1_ButtonClicked

   ' Add the toolbar to the form.
   Me.Controls.Add(toolBar1)
End Sub

C#

private void AddToolBar()
{
   // Add a toolbar and set some of its properties.
   toolBar1 = new ToolBar();
   toolBar1.Appearance = System.Windows.Forms.ToolBarAppearance.Flat;
   toolBar1.BorderStyle = System.Windows.Forms.BorderStyle.None;
   toolBar1.Buttons.Add(this.toolBarButton1);
   toolBar1.ButtonSize = new System.Drawing.Size(24, 24);
   toolBar1.Divider = true;
   toolBar1.DropDownArrows = true;
   toolBar1.ImageList = this.imageList1;
   toolBar1.ShowToolTips = true;
   toolBar1.Size = new System.Drawing.Size(292, 25);
   toolBar1.TabIndex = 0;
   toolBar1.TextAlign = System.Windows.Forms.ToolBarTextAlign.Right;
   toolBar1.Wrappable = false;
   
   // Add handlers for the ButtonClick and ButtonDropDown events.
   toolBar1.ButtonDropDown += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonDropDown);
   toolBar1.ButtonClick += 
     new ToolBarButtonClickEventHandler(toolBar1_ButtonClicked);

   // Add the toolbar to the form.
   this.Controls.Add(toolBar1);
}

C++

void AddToolBar()
{
   
   // Add a toolbar and set some of its properties.
   toolBar1 = gcnew ToolBar;
   toolBar1->Appearance = System::Windows::Forms::ToolBarAppearance::Flat;
   toolBar1->BorderStyle = System::Windows::Forms::BorderStyle::None;
   toolBar1->Buttons->Add( this->toolBarButton1 );
   toolBar1->ButtonSize = System::Drawing::Size( 24, 24 );
   toolBar1->Divider = true;
   toolBar1->DropDownArrows = true;
   toolBar1->ImageList = this->imageList1;
   toolBar1->ShowToolTips = true;
   toolBar1->Size = System::Drawing::Size( 292, 25 );
   toolBar1->TabIndex = 0;
   toolBar1->TextAlign = System::Windows::Forms::ToolBarTextAlign::Right;
   toolBar1->Wrappable = false;
   
   // Add handlers for the ButtonClick and ButtonDropDown events.
   toolBar1->ButtonDropDown += gcnew ToolBarButtonClickEventHandler( this,
 &MyToolBar::toolBar1_ButtonDropDown );
   toolBar1->ButtonClick += gcnew ToolBarButtonClickEventHandler( this,
 &MyToolBar::toolBar1_ButtonClicked );
   
   // Add the toolbar to the form.
   this->Controls->Add( toolBar1 );
}

J#

private void AddToolBar()
{
    // Add a toolbar and set some of its properties.
    toolBar1 = new ToolBar();
    toolBar1.set_Appearance(System.Windows.Forms.ToolBarAppearance.Flat);
    toolBar1.set_BorderStyle(System.Windows.Forms.BorderStyle.None);
    toolBar1.get_Buttons().Add(this.toolBarButton1);
    toolBar1.set_ButtonSize(new System.Drawing.Size(24, 24));
    toolBar1.set_Divider(true);
    toolBar1.set_DropDownArrows(true);
    toolBar1.set_ImageList(this.imageList1);
    toolBar1.set_ShowToolTips(true);
    toolBar1.set_Size(new System.Drawing.Size(292, 25));
    toolBar1.set_TabIndex(0);
    toolBar1.set_TextAlign(System.Windows.Forms.ToolBarTextAlign.Right);
    toolBar1.set_Wrappable(false);
    // Add handlers for the ButtonClick and ButtonDropDown events.
    toolBar1.add_ButtonDropDown(new ToolBarButtonClickEventHandler
        (toolBar1_ButtonDropDown));
    toolBar1.add_ButtonClick(new ToolBarButtonClickEventHandler
        (toolBar1_ButtonClicked));
    // Add the toolbar to the form.
    this.get_Controls().Add(toolBar1);
} //AddToolBar

プラットフォーム

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile for Pocket PC, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
ToolBar クラス
ToolBar メンバ
System.Windows.Forms 名前空間
ImageList クラス
ToolBarButton