ToolStripButton クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
テキストと画像を含めることができる選択可能な ToolStripItem を表します。
public ref class ToolStripButton : System::Windows::Forms::ToolStripItem
[System.Windows.Forms.Design.ToolStripItemDesignerAvailability(System.Windows.Forms.Design.ToolStripItemDesignerAvailability.ToolStrip)]
public class ToolStripButton : System.Windows.Forms.ToolStripItem
[<System.Windows.Forms.Design.ToolStripItemDesignerAvailability(System.Windows.Forms.Design.ToolStripItemDesignerAvailability.ToolStrip)>]
type ToolStripButton = class
inherit ToolStripItem
Public Class ToolStripButton
Inherits ToolStripItem
- 継承
- 属性
例
次のコード例は、ToolStrip上の画像とテキストの両方を持つ 2 つのToolStripButton コントロールを示しています。 新規ToolStripButtonをクリックすると、メッセージ ボックスが表示されます。
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Windows.Forms;
namespace WindowsApplication11
{
public class Form1 : Form
{
private ToolStripButton toolStripButton1;
private ToolStripButton toolStripButton2;
private ToolStrip toolStrip1;
public Form1()
{
InitializeComponent();
}
[STAThread]
static void Main()
{
Application.EnableVisualStyles();
Application.Run(new Form1());
}
private void InitializeComponent()
{
this.toolStrip1 = new System.Windows.Forms.ToolStrip();
this.toolStripButton1 = new System.Windows.Forms.ToolStripButton();
this.toolStripButton2 = new System.Windows.Forms.ToolStripButton();
this.toolStrip1.SuspendLayout();
this.SuspendLayout();
//
// toolStrip1
//
this.toolStrip1.Items.AddRange(new System.Windows.Forms.ToolStripItem[] {
this.toolStripButton1,
this.toolStripButton2});
this.toolStrip1.Location = new System.Drawing.Point(0, 0);
this.toolStrip1.Name = "toolStrip1";
this.toolStrip1.TabIndex = 0;
this.toolStrip1.Text = "toolStrip1";
//
// toolStripButton1
//
this.toolStripButton1.Image = Bitmap.FromFile("c:\\NewItem.bmp");
this.toolStripButton1.DisplayStyle = System.Windows.Forms.ToolStripItemDisplayStyle.ImageAndText;
this.toolStripButton1.ImageAlign = System.Drawing.ContentAlignment.MiddleLeft;
this.toolStripButton1.Name = "toolStripButton1";
this.toolStripButton1.Text = "&New";
this.toolStripButton1.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
this.toolStripButton1.Click += new System.EventHandler(this.toolStripButton1_Click);
//
// toolStripButton2
//
this.toolStripButton2.Image = Bitmap.FromFile("c:\\OpenItem.bmp");
this.toolStripButton2.DisplayStyle = System.Windows.Forms.ToolStripItemDisplayStyle.ImageAndText;
this.toolStripButton2.Name = "toolStripButton2";
this.toolStripButton2.Text = "&Open";
this.toolStripButton2.Click += new System.EventHandler(this.toolStripButton2_Click);
//
// Form1
//
this.ClientSize = new System.Drawing.Size(292, 273);
this.Controls.Add(this.toolStrip1);
this.Name = "Form1";
this.toolStrip1.ResumeLayout(false);
this.ResumeLayout(false);
this.PerformLayout();
}
private void toolStripButton1_Click(object sender, EventArgs e)
{
MessageBox.Show("You have mail.");
}
private void toolStripButton2_Click(object sender, EventArgs e)
{
// Add the response to the Click event here.
}
}
}
Imports System.Collections.Generic
Imports System.ComponentModel
Imports System.Data
Imports System.Drawing
Imports System.Windows.Forms
Public Class Form1
Inherits Form
Private WithEvents toolStripButton1 As ToolStripButton
Private WithEvents toolStripButton2 As ToolStripButton
Private toolStrip1 As ToolStrip
Public Sub New()
InitializeComponent()
End Sub
<STAThread()> _
Shared Sub Main()
Application.EnableVisualStyles()
Application.Run(New Form1())
End Sub
Private Sub InitializeComponent()
Me.toolStrip1 = New System.Windows.Forms.ToolStrip()
Me.toolStripButton1 = New System.Windows.Forms.ToolStripButton()
Me.toolStripButton2 = New System.Windows.Forms.ToolStripButton()
Me.toolStrip1.SuspendLayout()
Me.SuspendLayout()
'
' toolStrip1
'
Me.toolStrip1.Items.AddRange(New System.Windows.Forms.ToolStripItem() {Me.toolStripButton1, Me.toolStripButton2})
Me.toolStrip1.Location = New System.Drawing.Point(0, 0)
Me.toolStrip1.Name = "toolStrip1"
Me.toolStrip1.TabIndex = 0
Me.toolStrip1.Text = "toolStrip1"
'
' toolStripButton1
Me.toolStripButton1.Image = Bitmap.FromFile("c:\NewItem.bmp")
Me.toolStripButton1.DisplayStyle = System.Windows.Forms.ToolStripItemDisplayStyle.ImageAndText
Me.toolStripButton1.ImageAlign = System.Drawing.ContentAlignment.MiddleLeft
Me.toolStripButton1.Name = "toolStripButton1"
Me.toolStripButton1.Text = "&New"
Me.toolStripButton1.TextAlign = System.Drawing.ContentAlignment.MiddleRight
' toolStripButton2
'
Me.toolStripButton2.Image = Bitmap.FromFile("c:\OpenItem.bmp")
Me.toolStripButton2.DisplayStyle = System.Windows.Forms.ToolStripItemDisplayStyle.ImageAndText
Me.toolStripButton2.Name = "toolStripButton2"
Me.toolStripButton2.Text = "&Open"
'
' Form1
'
Me.ClientSize = New System.Drawing.Size(292, 273)
Me.Controls.Add(toolStrip1)
Me.Name = "Form1"
Me.toolStrip1.ResumeLayout(False)
Me.ResumeLayout(False)
Me.PerformLayout()
End Sub
Private Sub toolStripButton1_Click(sender As Object, e As EventArgs) Handles toolStripButton1.Click
MessageBox.Show("You have mail.")
End Sub
Private Sub toolStripButton2_Click(sender As Object, e As EventArgs) Handles toolStripButton2.Click
' Add the response to the Click event here.
End Sub
End Class
注釈
ToolStripButtonを使用して、テキストと画像の両方をサポートするツール バー ボタンを作成します。 ToolStripItem.ImageAlignプロパティとToolStripItem.TextAlignプロパティを使用して、ToolStripButtonイメージとテキストの配置を取得または設定します。
さまざまな罫線スタイルを使用して ToolStripButton を表示し、それを使用して操作状態を表し、アクティブ化することができます。 また、既定でフォーカスを設定するように定義することもできます。
ToolStripButtonは以前のバージョンのToolBarButton制御を置き換えて拡張しますが、ToolBarButtonは下位互換性と将来の使用の両方のために保持されます。
コンストラクター
| 名前 | 説明 |
|---|---|
| ToolStripButton() |
ToolStripButton クラスの新しいインスタンスを初期化します。 |
| ToolStripButton(Image) |
指定したイメージを表示する ToolStripButton クラスの新しいインスタンスを初期化します。 |
| ToolStripButton(String, Image, EventHandler, String) |
指定したテキストとイメージを表示し、Click イベントを発生させる、指定した名前を使用して、ToolStripButton クラスの新しいインスタンスを初期化します。 |
| ToolStripButton(String, Image, EventHandler) |
指定したテキストとイメージを表示し、Click イベントを発生させるToolStripButton クラスの新しいインスタンスを初期化します。 |
| ToolStripButton(String, Image) |
指定したテキストとイメージを表示する ToolStripButton クラスの新しいインスタンスを初期化します。 |
| ToolStripButton(String) |
指定したテキストを表示する ToolStripButton クラスの新しいインスタンスを初期化します。 |
プロパティ
| 名前 | 説明 |
|---|---|
| AccessibilityObject |
コントロールに割り当てられた AccessibleObject を取得します。 (継承元 ToolStripItem) |
| AccessibleDefaultActionDescription |
アクセシビリティ クライアント アプリケーションで使用するコントロールの既定のアクションの説明を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleDescription |
アクセシビリティ クライアント アプリケーションに報告される説明を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleName |
アクセシビリティ クライアント アプリケーションで使用するコントロールの名前を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleRole |
コントロールのユーザー インターフェイス要素の種類を指定する、コントロールのアクセス可能なロールを取得または設定します。 (継承元 ToolStripItem) |
| Alignment |
項目が ToolStripの先頭または末尾に揃えるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| AllowDrop |
ドラッグ アンド ドロップと項目の並べ替えが、実装するイベントによって処理されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Anchor |
ToolStripItemをバインドするコンテナーの端を取得または設定し、ToolStripItemのサイズを親と共に変更する方法を決定します。 (継承元 ToolStripItem) |
| AutoSize |
項目のサイズが自動的に設定されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| AutoToolTip |
ToolTipに既定のテキストまたはカスタム ToolStripButton テキストを表示するかどうかを示す値を取得または設定します。 |
| Available |
ToolStripItemをToolStripに配置するかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| BackColor |
アイテムの背景色を取得または設定します。 (継承元 ToolStripItem) |
| BackgroundImage |
アイテムに表示される背景イメージを取得または設定します。 (継承元 ToolStripItem) |
| BackgroundImageLayout |
ToolStripItemに使用される背景画像のレイアウトを取得または設定します。 (継承元 ToolStripItem) |
| Bounds |
アイテムのサイズと場所を取得します。 (継承元 ToolStripItem) |
| CanRaiseEvents |
コンポーネントがイベントを発生できるかどうかを示す値を取得します。 (継承元 Component) |
| CanSelect |
ToolStripButtonを選択できるかどうかを示す値を取得します。 |
| Checked |
ToolStripButtonが押されたかどうかを示す値を取得または設定します。 |
| CheckOnClick |
ToolStripButtonが自動的に押され、クリックされたときに押されないかどうかを示す値を取得または設定します。 |
| CheckState |
ToolStripButtonが既定で押された状態であるか、押されていない状態であるかを示す値を取得または設定します。 |
| Container |
IContainerを含むComponentを取得します。 (継承元 Component) |
| ContentRectangle |
背景の境界線を上書きすることなく、テキストやアイコンなどのコンテンツを ToolStripItem 内に配置できる領域を取得します。 (継承元 ToolStripItem) |
| DefaultAutoToolTip |
既定として定義されているツールヒントを表示するかどうかを示す値を取得します。 |
| DefaultDisplayStyle |
ToolStripItemに表示される内容を示す値を取得します。 (継承元 ToolStripItem) |
| DefaultMargin |
項目の既定の余白を取得します。 (継承元 ToolStripItem) |
| DefaultPadding |
アイテムの内部間隔の特性を取得します。 (継承元 ToolStripItem) |
| DefaultSize |
項目の既定のサイズを取得します。 (継承元 ToolStripItem) |
| DesignMode |
Componentが現在デザイン モードであるかどうかを示す値を取得します。 (継承元 Component) |
| DismissWhenClicked |
ToolStripDropDownの項目をクリックした後に非表示にするかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| DisplayStyle |
テキストと画像を ToolStripItemに表示するかどうかを取得または設定します。 (継承元 ToolStripItem) |
| Dock |
親コントロールにドッキングする ToolStripItem 罫線を取得または設定し、親コントロールで ToolStripItem のサイズを変更する方法を決定します。 (継承元 ToolStripItem) |
| DoubleClickEnabled |
マウスをダブルクリックして ToolStripItem をアクティブにできるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Enabled |
ToolStripItemの親コントロールが有効かどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Events |
この Componentにアタッチされているイベント ハンドラーの一覧を取得します。 (継承元 Component) |
| Font |
アイテムによって表示されるテキストのフォントを取得または設定します。 (継承元 ToolStripItem) |
| ForeColor |
項目の前景色を取得または設定します。 (継承元 ToolStripItem) |
| Height |
ToolStripItemの高さをピクセル単位で取得または設定します。 (継承元 ToolStripItem) |
| Image |
ToolStripItemに表示されるイメージを取得または設定します。 (継承元 ToolStripItem) |
| ImageAlign |
ToolStripItem上のイメージの配置を取得または設定します。 (継承元 ToolStripItem) |
| ImageIndex |
アイテムに表示されるイメージのインデックス値を取得または設定します。 (継承元 ToolStripItem) |
| ImageKey |
ImageListに表示されるToolStripItem内のイメージのキー アクセサーを取得または設定します。 (継承元 ToolStripItem) |
| ImageScaling |
ToolStripItem上のイメージがコンテナーに収まるように自動的にサイズ変更されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| ImageTransparentColor |
ToolStripItemイメージで透明として扱う色を取得または設定します。 (継承元 ToolStripItem) |
| IsDisposed |
オブジェクトが破棄されたかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| IsOnDropDown |
現在の Control のコンテナーが ToolStripDropDownかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| IsOnOverflow |
Placement プロパティが Overflow に設定されているかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| Margin |
項目と隣接する項目の間のスペースを取得または設定します。 (継承元 ToolStripItem) |
| MergeAction |
子メニューを親メニューと結合する方法を取得または設定します。 (継承元 ToolStripItem) |
| MergeIndex |
現在の ToolStrip内のマージされた項目の位置を取得または設定します。 (継承元 ToolStripItem) |
| Name |
項目の名前を取得または設定します。 (継承元 ToolStripItem) |
| Overflow |
項目が ToolStrip にアタッチされているか、 ToolStripOverflowButton にアタッチされているか、2 つの間に浮動できるかを取得または設定します。 (継承元 ToolStripItem) |
| Owner |
この項目の所有者を取得または設定します。 (継承元 ToolStripItem) |
| OwnerItem |
このToolStripItemの親ToolStripItemを取得します。 (継承元 ToolStripItem) |
| Padding |
アイテムの内容とその辺の間の内部間隔をピクセル単位で取得または設定します。 (継承元 ToolStripItem) |
| Parent |
ToolStripItemの親コンテナーを取得または設定します。 (継承元 ToolStripItem) |
| Placement |
アイテムの現在のレイアウトを取得します。 (継承元 ToolStripItem) |
| Pressed |
アイテムの状態が押されているかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| RightToLeft |
アイテムを右から左に配置し、テキストを右から左に書き込むかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| RightToLeftAutoMirrorImage |
ToolStripItem プロパティが RightToLeft に設定されている場合、Yesイメージを自動的にミラー化します。 (継承元 ToolStripItem) |
| Selected |
項目が選択されているかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| ShowKeyboardCues |
ショートカット キーを表示または非表示にするかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| Site | (継承元 Component) |
| Size |
項目のサイズを取得または設定します。 (継承元 ToolStripItem) |
| Tag |
アイテムに関するデータを含むオブジェクトを取得または設定します。 (継承元 ToolStripItem) |
| Text |
アイテムに表示するテキストを取得または設定します。 (継承元 ToolStripItem) |
| TextAlign |
ToolStripLabel上のテキストの配置を取得または設定します。 (継承元 ToolStripItem) |
| TextDirection |
ToolStripItemで使用されるテキストの向きを取得します。 (継承元 ToolStripItem) |
| TextImageRelation |
テキストと画像 ToolStripItem 相対的な位置を取得または設定します。 (継承元 ToolStripItem) |
| ToolTipText |
コントロールの ToolTip として表示されるテキストを取得または設定します。 (継承元 ToolStripItem) |
| Visible |
項目が表示されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Width |
ToolStripItemの幅をピクセル単位で取得または設定します。 (継承元 ToolStripItem) |
メソッド
イベント
| 名前 | 説明 |
|---|---|
| AvailableChanged |
Available プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| BackColorChanged |
BackColor プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| CheckedChanged |
Checked プロパティの値が変化したときに発生します。 |
| CheckStateChanged |
CheckState プロパティの値が変化したときに発生します。 |
| Click |
ToolStripItemがクリックされたときに発生します。 (継承元 ToolStripItem) |
| DisplayStyleChanged |
DisplayStyleが変更されたときに発生します。 (継承元 ToolStripItem) |
| Disposed |
コンポーネントが Dispose() メソッドの呼び出しによって破棄されるときに発生します。 (継承元 Component) |
| DoubleClick |
項目がマウスでダブルクリックされたときに発生します。 (継承元 ToolStripItem) |
| DragDrop |
ユーザーが項目をドラッグし、ユーザーがこの項目にドロップする必要があることを示すマウス ボタンを離すと発生します。 (継承元 ToolStripItem) |
| DragEnter |
ユーザーがこの項目のクライアント領域に項目をドラッグしたときに発生します。 (継承元 ToolStripItem) |
| DragLeave |
ユーザーが項目をドラッグし、マウス ポインターがこの項目のクライアント領域に移動しなくなったときに発生します。 (継承元 ToolStripItem) |
| DragOver |
ユーザーがこの項目のクライアント領域に項目をドラッグしたときに発生します。 (継承元 ToolStripItem) |
| EnabledChanged |
Enabled プロパティ値が変更されたときに発生します。 (継承元 ToolStripItem) |
| ForeColorChanged |
ForeColor プロパティ値が変更されたときに発生します。 (継承元 ToolStripItem) |
| GiveFeedback |
ドラッグ操作中に発生します。 (継承元 ToolStripItem) |
| LocationChanged |
ToolStripItemの場所が更新されたときに発生します。 (継承元 ToolStripItem) |
| MouseDown |
マウス ポインターが項目の上にあり、マウス ボタンが押されたときに発生します。 (継承元 ToolStripItem) |
| MouseEnter |
マウス ポインターが項目に入ったときに発生します。 (継承元 ToolStripItem) |
| MouseHover |
マウス ポインターが項目の上にマウス ポインターを置いたときに発生します。 (継承元 ToolStripItem) |
| MouseLeave |
マウス ポインターが項目から離れると発生します。 (継承元 ToolStripItem) |
| MouseMove |
マウス ポインターが項目の上に移動したときに発生します。 (継承元 ToolStripItem) |
| MouseUp |
マウス ポインターが項目の上にあり、マウス ボタンが離されたときに発生します。 (継承元 ToolStripItem) |
| OwnerChanged |
Owner プロパティが変更されたときに発生します。 (継承元 ToolStripItem) |
| Paint |
アイテムが再描画されたときに発生します。 (継承元 ToolStripItem) |
| QueryAccessibilityHelp |
アクセシビリティ クライアント アプリケーションが ToolStripItemのヘルプを呼び出すと発生します。 (継承元 ToolStripItem) |
| QueryContinueDrag |
ドラッグ アンド ドロップ操作中に発生し、ドラッグ ソースがドラッグ アンド ドロップ操作を取り消す必要があるかどうかを判断できるようにします。 (継承元 ToolStripItem) |
| RightToLeftChanged |
RightToLeft プロパティ値が変更されたときに発生します。 (継承元 ToolStripItem) |
| TextChanged |
Text プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| VisibleChanged |
Visible プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
明示的なインターフェイスの実装
| 名前 | 説明 |
|---|---|
| IDropTarget.OnDragDrop(DragEventArgs) |
DragDrop イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragEnter(DragEventArgs) |
DragEnter イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragLeave(EventArgs) |
DragLeave イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragOver(DragEventArgs) |
|