ToolStripControlHost クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
カスタム コントロールまたは Windows フォーム コントロールをホストします。
public ref class ToolStripControlHost : System::Windows::Forms::ToolStripItempublic class ToolStripControlHost : System.Windows.Forms.ToolStripItemtype ToolStripControlHost = class
inherit ToolStripItemPublic Class ToolStripControlHost
Inherits ToolStripItem- 継承
- 継承
- 派生
例
次のコード例では、 コントロールを使用MonthCalendarして を構築しToolStripControlHost、 を使用してOnSubscribeControlEventsイベントを処理し、そのメンバーの一部を に公開する方法をToolStripControlHost示します。
//Declare a class that inherits from ToolStripControlHost.
public ref class ToolStripMonthCalendar: public ToolStripControlHost
{
public:
// Call the base constructor passing in a MonthCalendar instance.
ToolStripMonthCalendar() : ToolStripControlHost( gcnew MonthCalendar ) {}
property MonthCalendar^ MonthCalendarControl
{
MonthCalendar^ get()
{
return static_cast<MonthCalendar^>(Control);
}
}
property Day FirstDayOfWeek
{
// Expose the MonthCalendar.FirstDayOfWeek as a property.
Day get()
{
return MonthCalendarControl->FirstDayOfWeek;
}
void set( Day value )
{
MonthCalendarControl->FirstDayOfWeek = value;
}
}
// Expose the AddBoldedDate method.
void AddBoldedDate( DateTime dateToBold )
{
MonthCalendarControl->AddBoldedDate( dateToBold );
}
protected:
// Subscribe and unsubscribe the control events you wish to expose.
void OnSubscribeControlEvents( System::Windows::Forms::Control^ c )
{
// Call the base so the base events are connected.
__super::OnSubscribeControlEvents( c );
// Cast the control to a MonthCalendar control.
MonthCalendar^ monthCalendarControl = (MonthCalendar^)c;
// Add the event.
monthCalendarControl->DateChanged += gcnew DateRangeEventHandler( this, &ToolStripMonthCalendar::HandleDateChanged );
}
void OnUnsubscribeControlEvents( System::Windows::Forms::Control^ c )
{
// Call the base method so the basic events are unsubscribed.
__super::OnUnsubscribeControlEvents( c );
// Cast the control to a MonthCalendar control.
MonthCalendar^ monthCalendarControl = (MonthCalendar^)c;
// Remove the event.
monthCalendarControl->DateChanged -= gcnew DateRangeEventHandler( this, &ToolStripMonthCalendar::HandleDateChanged );
}
public:
event DateRangeEventHandler^ DateChanged;
private:
// Declare the DateChanged event.
// Raise the DateChanged event.
void HandleDateChanged( Object^ sender, DateRangeEventArgs^ e )
{
if ( DateChanged != nullptr )
{
DateChanged( this, e );
}
}
};
//Declare a class that inherits from ToolStripControlHost.
public class ToolStripMonthCalendar : ToolStripControlHost
{
// Call the base constructor passing in a MonthCalendar instance.
public ToolStripMonthCalendar() : base (new MonthCalendar()) { }
public MonthCalendar MonthCalendarControl
{
get
{
return Control as MonthCalendar;
}
}
// Expose the MonthCalendar.FirstDayOfWeek as a property.
public Day FirstDayOfWeek
{
get
{
return MonthCalendarControl.FirstDayOfWeek;
}
set { MonthCalendarControl.FirstDayOfWeek = value; }
}
// Expose the AddBoldedDate method.
public void AddBoldedDate(DateTime dateToBold)
{
MonthCalendarControl.AddBoldedDate(dateToBold);
}
// Subscribe and unsubscribe the control events you wish to expose.
protected override void OnSubscribeControlEvents(Control c)
{
// Call the base so the base events are connected.
base.OnSubscribeControlEvents(c);
// Cast the control to a MonthCalendar control.
MonthCalendar monthCalendarControl = (MonthCalendar) c;
// Add the event.
monthCalendarControl.DateChanged +=
new DateRangeEventHandler(OnDateChanged);
}
protected override void OnUnsubscribeControlEvents(Control c)
{
// Call the base method so the basic events are unsubscribed.
base.OnUnsubscribeControlEvents(c);
// Cast the control to a MonthCalendar control.
MonthCalendar monthCalendarControl = (MonthCalendar) c;
// Remove the event.
monthCalendarControl.DateChanged -=
new DateRangeEventHandler(OnDateChanged);
}
// Declare the DateChanged event.
public event DateRangeEventHandler DateChanged;
// Raise the DateChanged event.
private void OnDateChanged(object sender, DateRangeEventArgs e)
{
if (DateChanged != null)
{
DateChanged(this, e);
}
}
}
'Declare a class that inherits from ToolStripControlHost.
Public Class ToolStripMonthCalendar
Inherits ToolStripControlHost
' Call the base constructor passing in a MonthCalendar instance.
Public Sub New()
MyBase.New(New MonthCalendar())
End Sub
Public ReadOnly Property MonthCalendarControl() As MonthCalendar
Get
Return CType(Control, MonthCalendar)
End Get
End Property
' Expose the MonthCalendar.FirstDayOfWeek as a property.
Public Property FirstDayOfWeek() As Day
Get
Return MonthCalendarControl.FirstDayOfWeek
End Get
Set
MonthCalendarControl.FirstDayOfWeek = value
End Set
End Property
' Expose the AddBoldedDate method.
Public Sub AddBoldedDate(ByVal dateToBold As DateTime)
MonthCalendarControl.AddBoldedDate(dateToBold)
End Sub
' Subscribe and unsubscribe the control events you wish to expose.
Protected Overrides Sub OnSubscribeControlEvents(ByVal c As Control)
' Call the base so the base events are connected.
MyBase.OnSubscribeControlEvents(c)
' Cast the control to a MonthCalendar control.
Dim monthCalendarControl As MonthCalendar = _
CType(c, MonthCalendar)
' Add the event.
AddHandler monthCalendarControl.DateChanged, _
AddressOf HandleDateChanged
End Sub
Protected Overrides Sub OnUnsubscribeControlEvents(ByVal c As Control)
' Call the base method so the basic events are unsubscribed.
MyBase.OnUnsubscribeControlEvents(c)
' Cast the control to a MonthCalendar control.
Dim monthCalendarControl As MonthCalendar = _
CType(c, MonthCalendar)
' Remove the event.
RemoveHandler monthCalendarControl.DateChanged, _
AddressOf HandleDateChanged
End Sub
' Declare the DateChanged event.
Public Event DateChanged As DateRangeEventHandler
' Raise the DateChanged event.
Private Sub HandleDateChanged(ByVal sender As Object, _
ByVal e As DateRangeEventArgs)
RaiseEvent DateChanged(Me, e)
End Sub
End Class
注釈
ToolStripControlHost は、ToolStripComboBox、ToolStripTextBox、および ToolStripProgressBar の基本クラスです。 ToolStripControlHost を使用すると、次の 2 つの方法で、カスタム コントロールなどの他のコントロールをホストできます。
Control の派生クラスを使用して、ToolStripControlHost を構築します。 ホストされているコントロールとプロパティに完全にアクセスするには、Control プロパティをそれによって表される実際のクラスにキャストして戻す必要があります。
ToolStripControlHost を拡張し、継承されたクラスのパラメーターなしのコンストラクターで、基底クラスのコンストラクターを呼び出して、Control から派生したクラスを渡します。 このオプションを使用すると、ToolStrip で簡単にアクセスできるように、コントロールの一般的なメソッドとプロパティをラップできます。
クラスをToolStripControlHost使用して、カスタマイズしたコントロールまたはその他のWindows フォーム コントロールをホストします。
をカスタマイズするには、 ToolStripItemから ToolStripControlHost 派生し、カスタム実装を作成します。 などの OnSubscribeControlEvents メソッドをオーバーライドして、ホストされたコントロールによって発生したイベントを処理したり、カスタム機能をプロパティに配置してホストされたコントロールを拡張したりできます。
コンストラクター
| ToolStripControlHost(Control) |
指定したコントロールをホストする ToolStripControlHost クラスの新しいインスタンスを初期化します。 |
| ToolStripControlHost(Control, String) |
指定したコントロールをホストし、指定した名前を持つ ToolStripControlHost クラスの新しいインスタンスを初期化します。 |
プロパティ
| AccessibilityObject |
コントロールに割り当てられた AccessibleObject を取得します。 (継承元 ToolStripItem) |
| AccessibleDefaultActionDescription |
アクセシビリティ クライアント アプリケーションで使用されるコントロールの既定のアクションの説明を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleDescription |
ユーザー補助クライアント アプリケーションに通知される説明を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleName |
ユーザー補助クライアント アプリケーションによって使用されるコントロールの名前を取得または設定します。 (継承元 ToolStripItem) |
| AccessibleRole |
コントロールのユーザー インターフェイス要素の型を指定する、コントロールのユーザー補助役割を取得または設定します。 (継承元 ToolStripItem) |
| Alignment |
項目が ToolStrip の先頭または末尾のいずれに合わせて配置されるかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| AllowDrop |
実装するイベントによって、ドラッグ アンド ドロップおよび項目の順番変更が処理されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Anchor |
ToolStripItem のバインド先コンテナーの端を取得または設定し、親のサイズ変更時に ToolStripItem のサイズがどのように変化するかを決定します。 (継承元 ToolStripItem) |
| AutoSize |
項目のサイズが自動的に設定されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| AutoToolTip |
ToolTipText のツールヒントに、Text プロパティまたは ToolStripItem プロパティを使用するかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Available |
ToolStripItem を ToolStrip 上に配置するかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| BackColor |
コントロールの背景色を取得または設定します。 |
| BackgroundImage |
コントロールに表示される背景イメージを取得または設定します。 |
| BackgroundImageLayout |
|
| BindingContext |
IBindableComponent の CurrencyManager のコレクションを取得または設定します。 (継承元 BindableComponent) |
| Bounds |
項目のサイズと位置を取得します。 (継承元 ToolStripItem) |
| CanRaiseEvents |
コンポーネントがイベントを発生させることがきるかどうかを示す値を取得します。 (継承元 Component) |
| CanSelect |
コントロールを選択できるかどうかを示す値を取得します。 |
| CausesValidation |
ホストされるコントロールがフォーカスを得たときに、そのコントロールが他のコントロールの検証イベントを発生させるかどうかを示す値を取得または設定します。 |
| Command |
ToolStripItem Click のICommandExecute(Object)イベントが呼び出されたときにメソッドを呼び出す を取得または設定します。 (継承元 ToolStripItem) |
| CommandParameter |
プロパティに割り当てられている Command にICommand渡されるパラメーターを取得または設定します。 (継承元 ToolStripItem) |
| Container |
IContainer を含む Component を取得します。 (継承元 Component) |
| ContentRectangle |
背景の境界線を上書きせずに、テキスト、アイコンなどのコンテンツを ToolStripItem 内に配置できる領域を取得します。 (継承元 ToolStripItem) |
| Control |
この Control がホストしている ToolStripControlHost を取得します。 |
| ControlAlign |
フォーム上のコントロールの配置を取得または設定します。 |
| DataBindings |
このIBindableComponent のデータ バインディング オブジェクトのコレクションを取得します。 (継承元 BindableComponent) |
| DefaultAutoToolTip |
既定として定義されている ToolTip を表示するかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| DefaultDisplayStyle |
ToolStripItem に表示されている内容を示す値を取得します。 (継承元 ToolStripItem) |
| DefaultMargin |
項目の既定のマージンを取得します。 (継承元 ToolStripItem) |
| DefaultPadding |
項目の内部のスペーシング特性を取得します。 (継承元 ToolStripItem) |
| DefaultSize |
コントロールの既定のサイズを取得します。 |
| DesignMode |
Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component) |
| DismissWhenClicked |
ToolStripDropDown の項目がクリックされた後、非表示にするかどうかを示す値を取得します。 (継承元 ToolStripItem) |
| DisplayStyle |
このクラスでは、このプロパティは使用されません。 |
| Dock |
ToolStripItem の境界のうちのどれが、親コントロールにドッキングしているかを取得または設定し、親のサイズ変更時に ToolStripItem のサイズがどのように変化するかを決定します。 (継承元 ToolStripItem) |
| DoubleClickEnabled |
このクラスでは、このプロパティは使用されません。 |
| Enabled |
ToolStripItem の親コントロールが有効かどうかを示す値を取得または設定します。 |
| Events |
Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component) |
| Focused |
コントロールに入力フォーカスがあるかどうかを示す値を取得します。 |
| Font |
ホストされるコントロールで使用されるフォントを取得または設定します。 |
| ForeColor |
ホストされるコントロールの前景色を取得または設定します。 |
| Height |
ToolStripItem の高さをピクセル単位で取得または設定します。 (継承元 ToolStripItem) |
| Image |
オブジェクトに関連付けられたイメージ。 |
| ImageAlign |
このクラスでは、このプロパティは使用されません。 |
| ImageIndex |
項目に表示されるイメージのインデックス値を取得または設定します。 (継承元 ToolStripItem) |
| ImageKey |
ImageList に表示されている ToolStripItem で、イメージのキー アクセサーを取得または設定します。 (継承元 ToolStripItem) |
| ImageScaling |
このクラスでは、このプロパティは使用されません。 |
| ImageTransparentColor |
このクラスでは、このプロパティは使用されません。 |
| 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) |
| Renderer |
カスタム コントロールまたは Windows フォーム コントロールをホストします。 (継承元 ToolStripItem) |
| RightToLeft |
コントロールの要素が、右から左へ表示されるフォントを使用するロケールをサポートするように配置されているかどうかを示す値を取得または設定します。 |
| RightToLeftAutoMirrorImage |
このクラスでは、このプロパティは使用されません。 |
| Selected |
項目が選択されているかどうかを示す値を取得します。 |
| ShowKeyboardCues |
ショートカット キーを表示、非表示のいずれにするかを示す値を取得します。 (継承元 ToolStripItem) |
| Site |
ホストされるコントロールのサイトを取得または設定します。 |
| Size |
ToolStripItem のサイズを取得または設定します。 |
| Tag |
アイテムに関するデータを含むオブジェクトを取得または設定します。 (継承元 ToolStripItem) |
| Text |
ホストされるコントロールに表示されるテキストを取得または設定します。 |
| TextAlign |
このクラスでは、このプロパティは使用されません。 |
| TextDirection |
このクラスでは、このプロパティは使用されません。 |
| TextImageRelation |
このクラスでは、このプロパティは使用されません。 |
| ToolTipText |
コントロールの ToolTip として表示されるテキストを取得または設定します。 (継承元 ToolStripItem) |
| Visible |
項目が表示されるかどうかを示す値を取得または設定します。 (継承元 ToolStripItem) |
| Width |
ToolStripItem の幅をピクセル単位で取得または設定します。 (継承元 ToolStripItem) |
メソッド
イベント
| AvailableChanged |
Available プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| BackColorChanged |
BackColor プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| BindingContextChanged |
バインド コンテキストが変更されたときに発生します。 (継承元 BindableComponent) |
| Click |
ToolStripItem がクリックされた時点で発生します。 (継承元 ToolStripItem) |
| CommandCanExecuteChanged |
プロパティにCanExecute(Object)割り当てられている Command のICommand状態が変更されたときに発生します。 (継承元 ToolStripItem) |
| CommandChanged |
プロパティの割り当て済み ICommand が Command 変更されたときに発生します。 (継承元 ToolStripItem) |
| CommandParameterChanged |
CommandParameter プロパティの値が変更されたときに発生します。 (継承元 ToolStripItem) |
| DisplayStyleChanged |
このクラスでは、このイベントは使用されません。 |
| Disposed |
Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component) |
| DoubleClick |
項目がマウスでダブルクリックされたときに発生します。 (継承元 ToolStripItem) |
| DragDrop |
ユーザーが項目をドラッグし、マウス ボタンを離したとき (つまり、項目がドロップされたとき) に発生します。 (継承元 ToolStripItem) |
| DragEnter |
この項目のクライアント領域に対し、ユーザーが項目をドラッグしたときに発生します。 (継承元 ToolStripItem) |
| DragLeave |
ユーザーが項目をドラッグし、マウス ポインターがこの項目のクライアント領域上から離れたときに発生します。 (継承元 ToolStripItem) |
| DragOver |
この項目のクライアント領域上に、ユーザーが項目をドラッグしたときに発生します。 (継承元 ToolStripItem) |
| EnabledChanged |
Enabled プロパティ値が変更されたときに発生します。 (継承元 ToolStripItem) |
| Enter |
ホストされるコントロールが入力されると発生します。 |
| ForeColorChanged |
ForeColor プロパティの値が変化すると発生します。 (継承元 ToolStripItem) |
| GiveFeedback |
ドラッグ操作中に発生します。 (継承元 ToolStripItem) |
| GotFocus |
ホストされるコントロールがフォーカスを受け取ると発生します。 |
| KeyDown |
ホストされるコントロールにフォーカスがあるときにキーが押し続けられると発生します。 |
| KeyPress |
ホストされるコントロールにフォーカスがあるときにキーが押されると発生します。 |
| KeyUp |
ホストされる コントロールにフォーカスがあるときにキーが離されると発生します。 |
| Leave |
ホストされるコントロールから入力フォーカスが移動すると発生します。 |
| LocationChanged |
ToolStripItem の位置が更新されたときに発生します。 (継承元 ToolStripItem) |
| LostFocus |
ホストされるコントロールがフォーカスを失うと発生します。 |
| 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) |
| SelectedChanged |
カスタム コントロールまたは Windows フォーム コントロールをホストします。 (継承元 ToolStripItem) |
| TextChanged |
Text プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
| Validated |
ホストされるコントロールの検証が正常に完了した後に発生します。 |
| Validating |
ホストされるコントロールが検証を行っているときに発生します。 |
| VisibleChanged |
Visible プロパティの値が変化したときに発生します。 (継承元 ToolStripItem) |
明示的なインターフェイスの実装
| IDropTarget.OnDragDrop(DragEventArgs) |
DragDrop イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragEnter(DragEventArgs) |
DragEnter イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragLeave(EventArgs) |
DragLeave イベントを発生させます。 (継承元 ToolStripItem) |
| IDropTarget.OnDragOver(DragEventArgs) |
|
適用対象
こちらもご覧ください
.NET