UserControl クラス
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
他のコントロールを作成するために使用できる空のコントロールを提供します。
public ref class UserControl : System::Windows::Forms::ContainerControlpublic class UserControl : System.Windows.Forms.ContainerControl[System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)]
[System.Runtime.InteropServices.ComVisible(true)]
public class UserControl : System.Windows.Forms.ContainerControltype UserControl = class
inherit ContainerControl[<System.Runtime.InteropServices.ClassInterface(System.Runtime.InteropServices.ClassInterfaceType.AutoDispatch)>]
[<System.Runtime.InteropServices.ComVisible(true)>]
type UserControl = class
inherit ContainerControlPublic Class UserControl
Inherits ContainerControl- 継承
- 派生
- 属性
例
次のコード例では、 を UserControl 作成し、複数のアプリケーションで再利用してユーザー情報を取得できます。 次の使用例は、 に複数Labelのコントロール、コントロール、TextBoxおよび をErrorProviderUserControl追加して、ユーザーの情報を収集します。 さらに、 の場合はユーザーの電子メール アドレスが検証されValidating、ErrorProviderデータのTextBox検証に失敗した場合は オブジェクトを使用してユーザーにフィードバックを提供します。 このコードは、他のアプリケーションで参照できるように DLL にコンパイルすることを目的としています。
#using <System.dll>
#using <System.Drawing.dll>
#using <System.Windows.Forms.dll>
using namespace System;
using namespace System::Windows::Forms;
using namespace System::Drawing;
using namespace System::ComponentModel;
namespace UserControls
{
public ref class MyCustomerInfoUserControl: public System::Windows::Forms::UserControl
{
private:
// Create the controls.
System::Windows::Forms::ErrorProvider^ errorProvider1;
System::Windows::Forms::TextBox^ textName;
System::Windows::Forms::TextBox^ textAddress;
System::Windows::Forms::TextBox^ textCity;
System::Windows::Forms::TextBox^ textStateProvince;
System::Windows::Forms::TextBox^ textPostal;
System::Windows::Forms::TextBox^ textCountryRegion;
System::Windows::Forms::TextBox^ textEmail;
System::Windows::Forms::Label ^ labelName;
System::Windows::Forms::Label ^ labelAddress;
System::Windows::Forms::Label ^ labelCityStateProvincePostal;
System::Windows::Forms::Label ^ labelCountryRegion;
System::Windows::Forms::Label ^ labelEmail;
System::ComponentModel::IContainer^ components;
public:
// Define the constructor.
MyCustomerInfoUserControl()
{
InitializeComponent();
}
// Initialize the control elements.
void InitializeComponent()
{
// Initialize the controls.
components = gcnew System::ComponentModel::Container;
errorProvider1 = gcnew System::Windows::Forms::ErrorProvider;
textName = gcnew System::Windows::Forms::TextBox;
textAddress = gcnew System::Windows::Forms::TextBox;
textCity = gcnew System::Windows::Forms::TextBox;
textStateProvince = gcnew System::Windows::Forms::TextBox;
textPostal = gcnew System::Windows::Forms::TextBox;
textCountryRegion = gcnew System::Windows::Forms::TextBox;
textEmail = gcnew System::Windows::Forms::TextBox;
labelName = gcnew System::Windows::Forms::Label;
labelAddress = gcnew System::Windows::Forms::Label;
labelCityStateProvincePostal = gcnew System::Windows::Forms::Label;
labelCountryRegion = gcnew System::Windows::Forms::Label;
labelEmail = gcnew System::Windows::Forms::Label;
// Set the tab order, text alignment, size, and location of the controls.
textName->Location = System::Drawing::Point( 120, 8 );
textName->Size = System::Drawing::Size( 232, 20 );
textName->TabIndex = 0;
textAddress->Location = System::Drawing::Point( 120, 32 );
textAddress->Size = System::Drawing::Size( 232, 20 );
textAddress->TabIndex = 1;
textCity->Location = System::Drawing::Point( 120, 56 );
textCity->Size = System::Drawing::Size( 96, 20 );
textCity->TabIndex = 2;
textStateProvince->Location = System::Drawing::Point( 216, 56 );
textStateProvince->Size = System::Drawing::Size( 56, 20 );
textStateProvince->TabIndex = 3;
textPostal->Location = System::Drawing::Point( 272, 56 );
textPostal->Size = System::Drawing::Size( 80, 20 );
textPostal->TabIndex = 4;
textCountryRegion->Location = System::Drawing::Point( 120, 80 );
textCountryRegion->Size = System::Drawing::Size( 232, 20 );
textCountryRegion->TabIndex = 5;
textEmail->Location = System::Drawing::Point( 120, 104 );
textEmail->Size = System::Drawing::Size( 232, 20 );
textEmail->TabIndex = 6;
labelName->Location = System::Drawing::Point( 8, 8 );
labelName->Size = System::Drawing::Size( 112, 23 );
labelName->Text = "Name:";
labelName->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
labelAddress->Location = System::Drawing::Point( 8, 32 );
labelAddress->Size = System::Drawing::Size( 112, 23 );
labelAddress->Text = "Address:";
labelAddress->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
labelCityStateProvincePostal->Location = System::Drawing::Point( 8, 56 );
labelCityStateProvincePostal->Size = System::Drawing::Size( 112, 23 );
labelCityStateProvincePostal->Text = "City, St/Prov. Postal:";
labelCityStateProvincePostal->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
labelCountryRegion->Location = System::Drawing::Point( 8, 80 );
labelCountryRegion->Size = System::Drawing::Size( 112, 23 );
labelCountryRegion->Text = "Country/Region:";
labelCountryRegion->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
labelEmail->Location = System::Drawing::Point( 8, 104 );
labelEmail->Size = System::Drawing::Size( 112, 23 );
labelEmail->Text = "email:";
labelEmail->TextAlign = System::Drawing::ContentAlignment::MiddleRight;
// Add the Validating and Validated handlers for textEmail.
textEmail->Validating += gcnew System::ComponentModel::CancelEventHandler( this, &MyCustomerInfoUserControl::textEmail_Validating );
textEmail->Validated += gcnew System::EventHandler( this, &MyCustomerInfoUserControl::textEmail_Validated );
// Add the controls to the user control.
array<System::Windows::Forms::Control^>^temp0 = {labelName,labelAddress,labelCityStateProvincePostal,labelCountryRegion,labelEmail,textName,textAddress,textCity,textStateProvince,textPostal,textCountryRegion,textEmail};
Controls->AddRange( temp0 );
// Size the user control.
Size = System::Drawing::Size( 375, 150 );
}
private:
void MyValidatingCode()
{
// Confirm there is text in the control.
if ( textEmail->Text->Length == 0 )
{
throw gcnew Exception( "Email address is a required field." );
}
// Confirm that there is a "." and an "@" in the email address.
else
// Confirm that there is a "." and an "@" in the email address.
if ( textEmail->Text->IndexOf( "." ) == -1 || textEmail->Text->IndexOf( "@" ) == -1 )
{
throw gcnew Exception( "Email address must be valid email address format.\nFor example: 'someone@example.com'" );
}
}
// Validate the data input by the user into textEmail.
void textEmail_Validating( Object^ /*sender*/, System::ComponentModel::CancelEventArgs^ e )
{
try
{
MyValidatingCode();
}
catch ( Exception^ ex )
{
// Cancel the event and select the text to be corrected by the user.
e->Cancel = true;
textEmail->Select(0,textEmail->Text->Length);
// Set the ErrorProvider error with the text to display.
this->errorProvider1->SetError( textEmail, ex->Message );
}
}
void textEmail_Validated( Object^ /*sender*/, System::EventArgs^ /*e*/ )
{
//If all conditions have been met, clear the error provider of errors.
errorProvider1->SetError( textEmail, "" );
}
};
}
// End Class
// End Namespace
using System;
using System.Windows.Forms;
using System.Drawing;
using System.ComponentModel;
namespace UserControls
{
public class MyCustomerInfoUserControl : System.Windows.Forms.UserControl
{
// Create the controls.
private System.Windows.Forms.ErrorProvider errorProvider1;
private System.Windows.Forms.TextBox textName;
private System.Windows.Forms.TextBox textAddress;
private System.Windows.Forms.TextBox textCity;
private System.Windows.Forms.TextBox textStateProvince;
private System.Windows.Forms.TextBox textPostal;
private System.Windows.Forms.TextBox textCountryRegion;
private System.Windows.Forms.TextBox textEmail;
private System.Windows.Forms.Label labelName;
private System.Windows.Forms.Label labelAddress;
private System.Windows.Forms.Label labelCityStateProvincePostal;
private System.Windows.Forms.Label labelCountryRegion;
private System.Windows.Forms.Label labelEmail;
private System.ComponentModel.IContainer components;
// Define the constructor.
public MyCustomerInfoUserControl()
{
InitializeComponent();
}
// Initialize the control elements.
public void InitializeComponent()
{
// Initialize the controls.
components = new System.ComponentModel.Container();
errorProvider1 = new System.Windows.Forms.ErrorProvider();
textName = new System.Windows.Forms.TextBox();
textAddress = new System.Windows.Forms.TextBox();
textCity = new System.Windows.Forms.TextBox();
textStateProvince = new System.Windows.Forms.TextBox();
textPostal = new System.Windows.Forms.TextBox();
textCountryRegion = new System.Windows.Forms.TextBox();
textEmail = new System.Windows.Forms.TextBox();
labelName = new System.Windows.Forms.Label();
labelAddress = new System.Windows.Forms.Label();
labelCityStateProvincePostal = new System.Windows.Forms.Label();
labelCountryRegion = new System.Windows.Forms.Label();
labelEmail = new System.Windows.Forms.Label();
// Set the tab order, text alignment, size, and location of the controls.
textName.Location = new System.Drawing.Point(120, 8);
textName.Size = new System.Drawing.Size(232, 20);
textName.TabIndex = 0;
textAddress.Location = new System.Drawing.Point(120, 32);
textAddress.Size = new System.Drawing.Size(232, 20);
textAddress.TabIndex = 1;
textCity.Location = new System.Drawing.Point(120, 56);
textCity.Size = new System.Drawing.Size(96, 20);
textCity.TabIndex = 2;
textStateProvince.Location = new System.Drawing.Point(216, 56);
textStateProvince.Size = new System.Drawing.Size(56, 20);
textStateProvince.TabIndex = 3;
textPostal.Location = new System.Drawing.Point(272, 56);
textPostal.Size = new System.Drawing.Size(80, 20);
textPostal.TabIndex = 4;
textCountryRegion.Location = new System.Drawing.Point(120, 80);
textCountryRegion.Size = new System.Drawing.Size(232, 20);
textCountryRegion.TabIndex = 5;
textEmail.Location = new System.Drawing.Point(120, 104);
textEmail.Size = new System.Drawing.Size(232, 20);
textEmail.TabIndex = 6;
labelName.Location = new System.Drawing.Point(8, 8);
labelName.Size = new System.Drawing.Size(112, 23);
labelName.Text = "Name:";
labelName.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
labelAddress.Location = new System.Drawing.Point(8, 32);
labelAddress.Size = new System.Drawing.Size(112, 23);
labelAddress.Text = "Address:";
labelAddress.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
labelCityStateProvincePostal.Location = new System.Drawing.Point(8, 56);
labelCityStateProvincePostal.Size = new System.Drawing.Size(112, 23);
labelCityStateProvincePostal.Text = "City, St/Prov. Postal:";
labelCityStateProvincePostal.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
labelCountryRegion.Location = new System.Drawing.Point(8, 80);
labelCountryRegion.Size = new System.Drawing.Size(112, 23);
labelCountryRegion.Text = "Country/Region:";
labelCountryRegion.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
labelEmail.Location = new System.Drawing.Point(8, 104);
labelEmail.Size = new System.Drawing.Size(112, 23);
labelEmail.Text = "email:";
labelEmail.TextAlign = System.Drawing.ContentAlignment.MiddleRight;
// Add the Validating and Validated handlers for textEmail.
textEmail.Validating += new System.ComponentModel.CancelEventHandler(textEmail_Validating);
textEmail.Validated += new System.EventHandler(textEmail_Validated);
// Add the controls to the user control.
Controls.AddRange(new System.Windows.Forms.Control[]
{
labelName,
labelAddress,
labelCityStateProvincePostal,
labelCountryRegion,
labelEmail,
textName,
textAddress,
textCity,
textStateProvince,
textPostal,
textCountryRegion,
textEmail
});
// Size the user control.
Size = new System.Drawing.Size(375, 150);
}
private void MyValidatingCode()
{
// Confirm there is text in the control.
if (textEmail.Text.Length == 0)
{
throw new Exception("Email address is a required field.");
}
// Confirm that there is a "." and an "@" in the email address.
else if(textEmail.Text.IndexOf(".") == -1 || textEmail.Text.IndexOf("@") == -1)
{
throw new Exception("Email address must be valid email address format." +
"\nFor example: 'someone@example.com'");
}
}
// Validate the data input by the user into textEmail.
private void textEmail_Validating(object sender, System.ComponentModel.CancelEventArgs e)
{
try
{
MyValidatingCode();
}
catch(Exception ex)
{
// Cancel the event and select the text to be corrected by the user.
e.Cancel = true;
textEmail.Select(0, textEmail.Text.Length);
// Set the ErrorProvider error with the text to display.
this.errorProvider1.SetError(textEmail,ex.Message);
}
}
private void textEmail_Validated(Object sender, System.EventArgs e)
{
//If all conditions have been met, clear the error provider of errors.
errorProvider1.SetError(textEmail, "");
}
} // End Class
} // End Namespace
Imports System.Windows.Forms
Imports System.Drawing
Imports System.ComponentModel
Namespace UserControls
Public Class MyCustomerInfoUserControl
Inherits System.Windows.Forms.UserControl
' Create the controls.
Private errorProvider1 As System.Windows.Forms.ErrorProvider
Private textName As System.Windows.Forms.TextBox
Private textAddress As System.Windows.Forms.TextBox
Private textCity As System.Windows.Forms.TextBox
Private textStateProvince As System.Windows.Forms.TextBox
Private textPostal As System.Windows.Forms.TextBox
Private textCountryRegion As System.Windows.Forms.TextBox
Private WithEvents textEmail As System.Windows.Forms.TextBox
Private labelName As System.Windows.Forms.Label
Private labelAddress As System.Windows.Forms.Label
Private labelCityStateProvincePostal As System.Windows.Forms.Label
Private labelCountryRegion As System.Windows.Forms.Label
Private labelEmail As System.Windows.Forms.Label
Private components As System.ComponentModel.IContainer
' Define the constructor.
Public Sub New()
InitializeComponent()
End Sub
' Initialize the control elements.
Public Sub InitializeComponent()
' Initialize the controls.
components = New System.ComponentModel.Container()
errorProvider1 = New System.Windows.Forms.ErrorProvider()
textName = New System.Windows.Forms.TextBox()
textAddress = New System.Windows.Forms.TextBox()
textCity = New System.Windows.Forms.TextBox()
textStateProvince = New System.Windows.Forms.TextBox()
textPostal = New System.Windows.Forms.TextBox()
textCountryRegion = New System.Windows.Forms.TextBox()
textEmail = New System.Windows.Forms.TextBox()
labelName = New System.Windows.Forms.Label()
labelAddress = New System.Windows.Forms.Label()
labelCityStateProvincePostal = New System.Windows.Forms.Label()
labelCountryRegion = New System.Windows.Forms.Label()
labelEmail = New System.Windows.Forms.Label()
' Set the tab order, text alignment, size, and location of the controls.
textName.Location = New System.Drawing.Point(120, 8)
textName.Size = New System.Drawing.Size(232, 20)
textName.TabIndex = 0
textAddress.Location = New System.Drawing.Point(120, 32)
textAddress.Size = New System.Drawing.Size(232, 20)
textAddress.TabIndex = 1
textCity.Location = New System.Drawing.Point(120, 56)
textCity.Size = New System.Drawing.Size(96, 20)
textCity.TabIndex = 2
textStateProvince.Location = New System.Drawing.Point(216, 56)
textStateProvince.Size = New System.Drawing.Size(56, 20)
textStateProvince.TabIndex = 3
textPostal.Location = New System.Drawing.Point(272, 56)
textPostal.Size = New System.Drawing.Size(80, 20)
textPostal.TabIndex = 4
textCountryRegion.Location = New System.Drawing.Point(120, 80)
textCountryRegion.Size = New System.Drawing.Size(232, 20)
textCountryRegion.TabIndex = 5
textEmail.Location = New System.Drawing.Point(120, 104)
textEmail.Size = New System.Drawing.Size(232, 20)
textEmail.TabIndex = 6
labelName.Location = New System.Drawing.Point(8, 8)
labelName.Size = New System.Drawing.Size(112, 23)
labelName.Text = "Name:"
labelName.TextAlign = System.Drawing.ContentAlignment.MiddleRight
labelAddress.Location = New System.Drawing.Point(8, 32)
labelAddress.Size = New System.Drawing.Size(112, 23)
labelAddress.Text = "Address:"
labelAddress.TextAlign = System.Drawing.ContentAlignment.MiddleRight
labelCityStateProvincePostal.Location = New System.Drawing.Point(8, 56)
labelCityStateProvincePostal.Size = New System.Drawing.Size(112, 23)
labelCityStateProvincePostal.Text = "City, St/Prov. Postal:"
labelCityStateProvincePostal.TextAlign = System.Drawing.ContentAlignment.MiddleRight
labelCountryRegion.Location = New System.Drawing.Point(8, 80)
labelCountryRegion.Size = New System.Drawing.Size(112, 23)
labelCountryRegion.Text = "Country/Region:"
labelCountryRegion.TextAlign = System.Drawing.ContentAlignment.MiddleRight
labelEmail.Location = New System.Drawing.Point(8, 104)
labelEmail.Size = New System.Drawing.Size(112, 23)
labelEmail.Text = "email:"
labelEmail.TextAlign = System.Drawing.ContentAlignment.MiddleRight
' Add the controls to the user control.
Controls.AddRange(New System.Windows.Forms.Control() {labelName, _
labelAddress, labelCityStateProvincePostal, labelCountryRegion, _
labelEmail, textName, textAddress, textCity, textStateProvince, _
textPostal, textCountryRegion, textEmail})
' Size the user control.
Size = New System.Drawing.Size(375, 150)
End Sub
Private Sub MyValidatingCode()
' Confirm there is text in the control.
If textEmail.Text.Length = 0 Then
Throw New Exception("Email address is a required field")
Else
' Confirm that there is a "." and an "@" in the email address.
If textEmail.Text.IndexOf(".") = - 1 Or textEmail.Text.IndexOf("@") = - 1 Then
Throw New Exception("Email address must be valid email address format." + _
Microsoft.VisualBasic.ControlChars.Cr + "For example 'someone@example.com'")
End If
End If
End Sub
' Validate the data input by the user into textEmail.
Private Sub textEmail_Validating(sender As Object, _
e As System.ComponentModel.CancelEventArgs) Handles textEmail.Validating
Try
MyValidatingCode()
Catch ex As Exception
' Cancel the event and select the text to be corrected by the user.
e.Cancel = True
textEmail.Select(0, textEmail.Text.Length)
' Set the ErrorProvider error with the text to display.
Me.errorProvider1.SetError(textEmail, ex.Message)
End Try
End Sub
Private Sub textEmail_Validated(sender As Object, _
e As System.EventArgs) Handles textEmail.Validated
' If all conditions have been met, clear the error provider of errors.
errorProvider1.SetError(textEmail, "")
End Sub
End Class
End Namespace
注釈
をContainerControlUserControl拡張することで、ユーザー コントロールに必要なすべての標準の配置およびニーモニック処理コードが継承されます。
をUserControl使用すると、アプリケーションまたはorganization内の複数の場所で使用できるコントロールを作成できます。 ユーザーに入力を求める一般的なデータの検証に必要なすべてのコードを含めることができます。この例としては、電子メール アドレス (「例」セクションを参照)、電話番号、郵便番号などがあります。 ユーザー コントロールのもう 1 つの効率的な使用方法は、ほぼすべてのアプリケーションで一般的に使用する静的な項目を単に または にプリロードComboBoxListBoxすることです。その一部の例は、国/地域、都市、州、およびオフィスの場所です。 カスタム コントロールの作成の詳細については、「Developing Custom Windows フォーム Controls with the .NET Framework」を参照してください。
注意
複数のクラスのユーザー コントロールを含む名前空間を作成し、それを 1 つの DLL にコンパイルすることを検討できます。 この DLL は、アプリケーションまたはorganization内のすべてのアプリケーションと共に参照および配布できます。 これにより、多くのアプリケーションでユーザー コントロールを参照し、ユーザー コントロールの包含要素をレイアウトしてコーディングする時間を節約できます。 また、ユーザー コントロールを使用すると、アプリケーション内またはアプリケーション間で一貫性を保つこともできます。たとえば、すべてのアドレス情報入力ブロックの外観と動作はすべて同じです。 一貫性により、アプリケーションの外観が洗練され、プロフェッショナルになります。
Windows フォームUserControl派生クラスは、フォーム内、別UserControlの クラス、Web ページ上のインターネット エクスプローラー内、またはフォームでホストされているコントロール内WebBrowserでホストできます。
注意
コントロール内で をUserControlWebBrowserホストする場合、タグ値 MSThemeCompatibleを使用して Visual Styles をMETAオフにすることはできません。 ビジュアル スタイルの詳細については、「表示スタイル を使用したコントロールのレンダリング」を参照してください。
コンストラクター
| UserControl() |
UserControl クラスの新しいインスタンスを初期化します。 |
フィールド
| ScrollStateAutoScrolling |
AutoScroll プロパティの値を判断します。 (継承元 ScrollableControl) |
| ScrollStateFullDrag |
ユーザーがウィンドウ全体のドラッグを有効にしているかどうかを判断します。 (継承元 ScrollableControl) |
| ScrollStateHScrollVisible |
HScroll プロパティの値が |
| ScrollStateUserHasScrolled |
ユーザーが ScrollableControl コントロール内をスクロールしたかどうかを判断します。 (継承元 ScrollableControl) |
| ScrollStateVScrollVisible |
VScroll プロパティの値が |
プロパティ
| AccessibilityObject |
コントロールに割り当てられた AccessibleObject を取得します。 (継承元 Control) |
| AccessibleDefaultActionDescription |
アクセシビリティ クライアント アプリケーションで使用されるコントロールの既定のアクションの説明を取得または設定します。 (継承元 Control) |
| AccessibleDescription |
ユーザー補助クライアント アプリケーションによって使用される、コントロールの説明を取得または設定します。 (継承元 Control) |
| AccessibleName |
ユーザー補助クライアント アプリケーションによって使用されるコントロールの名前を取得または設定します。 (継承元 Control) |
| AccessibleRole |
コントロールのアクセスできる役割を取得または設定します。 (継承元 Control) |
| ActiveControl |
コンテナー コントロール上のアクティブ コントロールを取得または設定します。 (継承元 ContainerControl) |
| AllowDrop |
ユーザーがコントロールにドラッグしたデータを、そのコントロールが受け入れることができるかどうかを示す値を取得または設定します。 (継承元 Control) |
| Anchor |
コントロールがバインドされるコンテナーの端を取得または設定し、親のサイズ変更時に、コントロールのサイズがどのように変化するかを決定します。 (継承元 Control) |
| AutoScaleDimensions |
コントロールがデザインされたときの寸法を取得または設定します。 (継承元 ContainerControl) |
| AutoScaleFactor |
現在の自動スケーリングの寸法と設計時の自動スケーリングの寸法の間のスケール ファクターを取得します。 (継承元 ContainerControl) |
| AutoScaleMode |
コントロールの自動スケーリング モードを取得または設定します。 (継承元 ContainerControl) |
| AutoScroll |
コンテナーで、表示されている境界の外にあるコントロールにユーザーがスクロールできるかどうかを示す値を取得または設定します。 (継承元 ScrollableControl) |
| AutoScrollMargin |
自動スクロールのマージンのサイズを取得または設定します。 (継承元 ScrollableControl) |
| AutoScrollMinSize |
自動スクロールの最小サイズを取得または設定します。 (継承元 ScrollableControl) |
| AutoScrollOffset |
ScrollControlIntoView(Control) でのこのコントロールのスクロール先を取得または設定します。 (継承元 Control) |
| AutoScrollPosition |
自動スクロールの位置を取得または設定します。 (継承元 ScrollableControl) |
| AutoSize |
このクラスでは、このプロパティは使用されません。 |
| AutoSize |
このクラスでは、このプロパティは使用されません。 (継承元 Control) |
| AutoSizeMode |
コントロールのサイズを自動的に変更する方法を取得または設定します。 |
| AutoValidate |
ユーザーが別のコントロールにフォーカスを移したときに、コントロールが検証を実行する方法を取得または設定します。 |
| AutoValidate |
フォーカスが変更されたときに、このコンテナーのコントロールを自動的に検証するかどうかを示す値を取得または設定します。 (継承元 ContainerControl) |
| BackColor |
コントロールの背景色を取得または設定します。 (継承元 Control) |
| BackgroundImage |
コントロールに表示される背景イメージを取得または設定します。 (継承元 Control) |
| BackgroundImageLayout |
ImageLayout 列挙型で定義される背景画像のレイアウトを取得または設定します。 (継承元 Control) |
| BindingContext |
コントロールの BindingContext を取得または設定します。 (継承元 ContainerControl) |
| BorderStyle |
ユーザー コントロールの境界線スタイルを取得または設定します。 |
| Bottom |
コントロールの下端とコンテナーのクライアント領域の上端の間の距離をピクセルで取得します。 (継承元 Control) |
| Bounds |
クライアント以外の要素を含むコントロールの、親コントロールに対する相対的なサイズおよび位置をピクセル単位で取得または設定します。 (継承元 Control) |
| CanEnableIme |
ImeMode プロパティをアクティブな値に設定して、IME サポートを有効にできるかどうかを示す値を取得します。 (継承元 ContainerControl) |
| CanFocus |
コントロールがフォーカスを受け取ることができるかどうかを示す値を取得します。 (継承元 Control) |
| CanRaiseEvents |
コントロールでイベントが発生するかどうかを決定します。 (継承元 Control) |
| CanSelect |
コントロールを選択できるかどうかを示す値を取得します。 (継承元 Control) |
| Capture |
コントロールがマウスをキャプチャしたかどうかを示す値を取得または設定します。 (継承元 Control) |
| CausesValidation |
そのコントロールが原因で、フォーカスを受け取ると検証が必要なコントロールに対して、検証が実行されるかどうかを示す値を取得または設定します。 (継承元 Control) |
| ClientRectangle |
コントロールのクライアント領域を表す四角形を取得します。 (継承元 Control) |
| ClientSize |
コントロールのクライアント領域の高さと幅を取得または設定します。 (継承元 Control) |
| CompanyName |
コントロールを含んでいるアプリケーションの会社または作成者の名前を取得します。 (継承元 Control) |
| Container |
IContainer を含む Component を取得します。 (継承元 Component) |
| ContainsFocus |
コントロール、またはその子コントロールの 1 つに、現在入力フォーカスがあるかどうかを示す値を取得します。 (継承元 Control) |
| ContextMenu |
コントロールに関連付けられたショートカット メニューを取得または設定します。 (継承元 Control) |
| ContextMenuStrip |
このコントロールに関連付けられている ContextMenuStrip を取得または設定します。 (継承元 Control) |
| Controls |
コントロール内に格納されているコントロールのコレクションを取得します。 (継承元 Control) |
| Created |
コントロールが作成されているかどうかを示す値を取得します。 (継承元 Control) |
| CreateParams |
コントロール ハンドルが作成されるときに必要な作成パラメーターを取得します。 |
| CreateParams |
コントロール ハンドルが作成されるときに必要な作成パラメーターを取得します。 (継承元 ContainerControl) |
| CurrentAutoScaleDimensions |
現在の画面の実行時寸法を取得します。 (継承元 ContainerControl) |
| Cursor |
マウス ポインターがコントロールの上にあるときに表示されるカーソルを取得または設定します。 (継承元 Control) |
| DataBindings |
コントロールのデータ連結を取得します。 (継承元 Control) |
| DataContext |
データ バインディングの目的でデータ コンテキストを取得または設定します。 これはアンビエント プロパティです。 (継承元 Control) |
| DefaultCursor |
コントロールの既定のカーソルを取得または設定します。 (継承元 Control) |
| DefaultImeMode |
コントロールがサポートしている既定の IME (Input Method Editor) モードを取得します。 (継承元 Control) |
| DefaultMargin |
コントロール間に既定で指定されている空白をピクセル単位で取得します。 (継承元 Control) |
| DefaultMaximumSize |
コントロールの既定の最大サイズとして指定されている長さおよび高さをピクセル単位で取得します。 (継承元 Control) |
| DefaultMinimumSize |
コントロールの既定の最小サイズとして指定されている長さおよび高さをピクセル単位で取得します。 (継承元 Control) |
| DefaultPadding |
コントロールの内容の既定の内部間隔をピクセル単位で取得します。 (継承元 Control) |
| DefaultSize |
コントロールの既定のサイズを取得します。 |
| DesignMode |
Component が現在デザイン モードかどうかを示す値を取得します。 (継承元 Component) |
| DeviceDpi |
コントロールが現在表示されているディスプレイ デバイスの DPI 値を取得します。 (継承元 Control) |
| DisplayRectangle |
コントロールの仮想表示領域を表す四角形を取得します。 (継承元 ScrollableControl) |
| Disposing |
基本 Control クラスが破棄処理中かどうかを示す値を取得します。 (継承元 Control) |
| Dock |
コントロールの境界のうち、親コントロールにドッキングする境界を取得または設定します。また、コントロールのサイズが親コントロール内でどのように変化するかを決定します。 (継承元 Control) |
| DockPadding |
コントロールのすべての端に対するドッキング埋め込みの設定を取得します。 (継承元 ScrollableControl) |
| DoubleBuffered |
ちらつきを軽減または回避するために、2 次バッファーを使用してコントロールの表面を再描画するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Enabled |
コントロールがユーザーとの対話に応答できるかどうかを示す値を取得または設定します。 (継承元 Control) |
| Events |
Component に結び付けられているイベント ハンドラーのリストを取得します。 (継承元 Component) |
| Focused |
コントロールに入力フォーカスがあるかどうかを示す値を取得します。 (継承元 Control) |
| Font |
コントロールによって表示されるテキストのフォントを取得または設定します。 (継承元 Control) |
| FontHeight |
コントロールのフォントの高さを取得または設定します。 (継承元 Control) |
| ForeColor |
コントロールの前景色を取得または設定します。 (継承元 Control) |
| Handle |
コントロールのバインド先のウィンドウ ハンドルを取得します。 (継承元 Control) |
| HasChildren |
コントロールに 1 つ以上の子コントロールが格納されているかどうかを示す値を取得します。 (継承元 Control) |
| Height |
コントロールの高さを取得または設定します。 (継承元 Control) |
| HorizontalScroll |
水平スクロール バーに関連付けられている特性を取得します。 (継承元 ScrollableControl) |
| HScroll |
水平スクロール バーが表示されるかどうかを示す値を、取得または設定します。 (継承元 ScrollableControl) |
| ImeMode |
コントロールの IME (Input Method Editor) モードを取得または設定します。 (継承元 Control) |
| ImeModeBase |
コントロールの IME モードを取得または設定します。 (継承元 Control) |
| InvokeRequired |
呼び出し元がコントロールの作成されたスレッドと異なるスレッド上にあるため、コントロールに対してメソッドの呼び出しを実行するときに、呼び出し元で invoke メソッドを呼び出す必要があるかどうかを示す値を取得します。 (継承元 Control) |
| IsAccessible |
コントロールがユーザー補助アプリケーションに表示されるかどうかを示す値を取得または設定します。 (継承元 Control) |
| IsAncestorSiteInDesignMode |
このコントロールの先祖の 1 つがサイト化され、そのサイトが DesignMode に存在するかどうかを示します。 このプロパティは読み取り専用です。 (継承元 Control) |
| IsDisposed |
コントロールが破棄されているかどうかを示す値を取得します。 (継承元 Control) |
| IsHandleCreated |
コントロールにハンドルが関連付けられているかどうかを示す値を取得します。 (継承元 Control) |
| IsMirrored |
コントロールがミラー化されるかどうかを示す値を取得します。 (継承元 Control) |
| LayoutEngine |
コントロールのレイアウト エンジンのキャッシュ インスタンスを取得します。 (継承元 Control) |
| Left |
コントロールの左端とコンテナーのクライアント領域の左端の間の距離をピクセルで取得または設定します。 (継承元 Control) |
| Location |
コンテナーの左上隅に対する相対座標として、コントロールの左上隅の座標を取得または設定します。 (継承元 Control) |
| Margin |
コントロール間の空白を取得または設定します。 (継承元 Control) |
| MaximumSize |
GetPreferredSize(Size) が指定できる上限のサイズを取得または設定します。 (継承元 Control) |
| MinimumSize |
GetPreferredSize(Size) が指定できる下限のサイズを取得または設定します。 (継承元 Control) |
| Name |
コントロールの名前を取得または設定します。 (継承元 Control) |
| Padding |
コントロールの埋め込みを取得または設定します。 (継承元 Control) |
| Parent |
コントロールの親コンテナーを取得または設定します。 (継承元 Control) |
| ParentForm |
コンテナー コントロールが割り当てられるフォームを取得します。 (継承元 ContainerControl) |
| PreferredSize |
コントロールが適合する四角形領域のサイズを取得します。 (継承元 Control) |
| ProductName |
コントロールを格納しているアセンブリの製品名を取得します。 (継承元 Control) |
| ProductVersion |
コントロールを格納しているアセンブリのバージョンを取得します。 (継承元 Control) |
| RecreatingHandle |
コントロールが現在そのコントロールのハンドルを再作成中かどうかを示す値を取得します。 (継承元 Control) |
| Region |
コントロールに関連付けられたウィンドウ領域を取得または設定します。 (継承元 Control) |
| RenderRightToLeft |
古い.
古い.
このプロパティは使用されなくなりました。 (継承元 Control) |
| ResizeRedraw |
サイズが変更されたときに、コントロールがコントロール自体を再描画するかどうかを示す値を取得または設定します。 (継承元 Control) |
| Right |
コントロールの右端とコンテナーのクライアント領域の左端の間の距離をピクセルで取得します。 (継承元 Control) |
| RightToLeft |
コントロールの要素が、右から左へ表示されるフォントを使用するロケールをサポートするように配置されているかどうかを示す値を取得または設定します。 (継承元 Control) |
| ScaleChildren |
子コントロールの表示スケールを決定する値を取得します。 (継承元 Control) |
| ShowFocusCues |
コントロールがフォーカスを示す四角形を表示する必要があるかどうかを示す値を取得します。 (継承元 Control) |
| ShowKeyboardCues |
ユーザー インターフェイスがキーボード アクセラレータを表示または非表示にする適切な状態かどうかを示す値を取得します。 (継承元 Control) |
| Site |
コントロールのサイトを取得または設定します。 (継承元 Control) |
| Size |
コントロールの高さと幅を取得または設定します。 (継承元 Control) |
| TabIndex |
コンテナー内のコントロールのタブ オーダーを取得または設定します。 (継承元 Control) |
| TabStop |
ユーザーが Tab キーを使用することによってこのコントロールにフォーカスを移すことができるかどうかを示す値を取得または設定します。 (継承元 Control) |
| Tag |
コントロールに関するデータを格納するオブジェクトを取得または設定します。 (継承元 Control) |
| Text |
このコントロールに関連付けられているテキストを取得または設定します。 |
| Top |
コントロールの上端とコンテナーのクライアント領域の上端の間の距離をピクセル単位で取得または設定します。 (継承元 Control) |
| TopLevelControl |
別の Windows フォーム コントロールを親として持たない親コントロールを取得します。 一般的に、これは、コントロールを格納している最も外側の Form です。 (継承元 Control) |
| UseWaitCursor |
現在のコントロールおよびすべての子コントロールに待機カーソルを使用するかどうかを示す値を取得または設定します。 (継承元 Control) |
| VerticalScroll |
垂直スクロール バーに関連付けられた特性を取得します。 (継承元 ScrollableControl) |
| Visible |
コントロールとそのすべての子コントロールが表示されているかどうかを示す値を取得または設定します。 (継承元 Control) |
| VScroll |
垂直スクロール バーが表示されるかどうかを示す値を、取得または設定します。 (継承元 ScrollableControl) |
| Width |
コントロールの幅を取得または設定します。 (継承元 Control) |
| WindowTarget |
このクラスでは、このプロパティは使用されません。 (継承元 Control) |
メソッド
イベント
| AutoSizeChanged |
AutoSize プロパティが変更されたときに発生します。 |
| AutoSizeChanged |
このクラスでは、このイベントは使用されません。 (継承元 Control) |
| AutoValidateChanged |
AutoValidate プロパティが変更されたときに発生します。 |
| AutoValidateChanged |
AutoValidate プロパティが変更されたときに発生します。 (継承元 ContainerControl) |
| BackColorChanged |
BackColor プロパティの値が変化したときに発生します。 (継承元 Control) |
| BackgroundImageChanged |
BackgroundImage プロパティの値が変化したときに発生します。 (継承元 Control) |
| BackgroundImageLayoutChanged |
BackgroundImageLayout プロパティが変更されたときに発生します。 (継承元 Control) |
| BindingContextChanged |
BindingContext プロパティの値が変化したときに発生します。 (継承元 Control) |
| CausesValidationChanged |
CausesValidation プロパティの値が変化したときに発生します。 (継承元 Control) |
| ChangeUICues |
フォーカスまたはキーボードのユーザー インターフェイス (UI) キューが変更されるときに発生します。 (継承元 Control) |
| Click |
コントロールがクリックされたときに発生します。 (継承元 Control) |
| ClientSizeChanged |
ClientSize プロパティの値が変化したときに発生します。 (継承元 Control) |
| ContextMenuChanged |
ContextMenu プロパティの値が変化したときに発生します。 (継承元 Control) |
| ContextMenuStripChanged |
ContextMenuStrip プロパティの値が変化したときに発生します。 (継承元 Control) |
| ControlAdded |
新しいコントロールが Control.ControlCollection に追加されたときに発生します。 (継承元 Control) |
| ControlRemoved |
Control.ControlCollection からコントロールが削除されたときに発生します。 (継承元 Control) |
| CursorChanged |
Cursor プロパティの値が変化したときに発生します。 (継承元 Control) |
| DataContextChanged |
DataContext プロパティの値が変化したときに発生します。 (継承元 Control) |
| Disposed |
Dispose() メソッドの呼び出しによってコンポーネントが破棄されるときに発生します。 (継承元 Component) |
| DockChanged |
Dock プロパティの値が変化したときに発生します。 (継承元 Control) |
| DoubleClick |
コントロールがダブルクリックされたときに発生します。 (継承元 Control) |
| DpiChangedAfterParent |
親コントロールまたはフォームの DPI が変更された後に、コントロールの DPI 設定がプログラムで変更されたときに発生します。 (継承元 Control) |
| DpiChangedBeforeParent |
親コントロールまたはフォームの DPI 変更イベントが発生する前に、コントロールの DPI 設定がプログラムで変更されたときに発生します。 (継承元 Control) |
| DragDrop |
ドラッグ アンド ドロップ操作が完了したときに発生します。 (継承元 Control) |
| DragEnter |
オブジェクトがコントロールの境界内にドラッグされると発生します。 (継承元 Control) |
| DragLeave |
オブジェクトがコントロールの境界外にドラッグされたときに発生します。 (継承元 Control) |
| DragOver |
オブジェクトがコントロールの境界を越えてドラッグされると発生します。 (継承元 Control) |
| EnabledChanged |
Enabled プロパティ値が変更されたときに発生します。 (継承元 Control) |
| Enter |
コントロールが入力されると発生します。 (継承元 Control) |
| FontChanged |
Font プロパティの値が変化すると発生します。 (継承元 Control) |
| ForeColorChanged |
ForeColor プロパティの値が変化すると発生します。 (継承元 Control) |
| GiveFeedback |
ドラッグ操作中に発生します。 (継承元 Control) |
| GotFocus |
コントロールがフォーカスを受け取ると発生します。 (継承元 Control) |
| HandleCreated |
コントロールに対してハンドルが作成されると発生します。 (継承元 Control) |
| HandleDestroyed |
コントロールのハンドルが破棄されているときに発生します。 (継承元 Control) |
| HelpRequested |
ユーザーがコントロールのヘルプを要求すると発生します。 (継承元 Control) |
| ImeModeChanged |
ImeMode プロパティが変更された場合に発生します。 (継承元 Control) |
| Invalidated |
コントロールの表示に再描画が必要なときに発生します。 (継承元 Control) |
| KeyDown |
コントロールにフォーカスがあるときにキーが押されると発生します。 (継承元 Control) |
| KeyPress |
コントロールにフォーカスがあるときに、文字、 スペース、または Backspace キーが押された場合に発生します。 (継承元 Control) |
| KeyUp |
コントロールにフォーカスがあるときにキーが離されると発生します。 (継承元 Control) |
| Layout |
コントロールの子コントロールの位置を変更する必要があるときに発生します。 (継承元 Control) |
| Leave |
入力フォーカスがコントロールを離れると発生します。 (継承元 Control) |
| Load |
コントロールが初めて表示される前に発生します。 |
| LocationChanged |
Location プロパティ値が変更されたときに発生します。 (継承元 Control) |
| LostFocus |
コントロールがフォーカスを失ったときに発生します。 (継承元 Control) |
| MarginChanged |
コントロールのマージンが変更されたときに発生します。 (継承元 Control) |
| MouseCaptureChanged |
コントロールがマウスのキャプチャを失うと発生します。 (継承元 Control) |
| MouseClick |
マウスでコントロールをクリックしたときに発生します。 (継承元 Control) |
| MouseDoubleClick |
マウスでコントロールをダブルクリックしたときに発生します。 (継承元 Control) |
| MouseDown |
マウス ポインターがコントロール上にあり、マウス ボタンがクリックされると発生します。 (継承元 Control) |
| MouseEnter |
マウス ポインターによってコントロールが入力されると発生します。 (継承元 Control) |
| MouseHover |
マウス ポインターをコントロールの上に重ねると発生します。 (継承元 Control) |
| MouseLeave |
マウス ポインターがコントロールを離れると発生します。 (継承元 Control) |
| MouseMove |
マウス ポインターがコントロール上を移動すると発生します。 (継承元 Control) |
| MouseUp |
マウス ポインターがコントロール上にある状態でマウス ボタンが離されると発生します。 (継承元 Control) |
| MouseWheel |
コントロールにフォーカスがある間に、マウスのホイールを移動したときに発生します。 (継承元 Control) |
| Move |
コントロールが移動されると発生します。 (継承元 Control) |
| PaddingChanged |
コントロールの埋め込みが変更されたときに発生します。 (継承元 Control) |
| Paint |
コントロールが再描画されると発生します。 (継承元 Control) |
| ParentChanged |
Parent プロパティの値が変化すると発生します。 (継承元 Control) |
| PreviewKeyDown |
このコントロールにフォーカスがあるときにキーが押された場合、KeyDown イベントの前に発生します。 (継承元 Control) |
| QueryAccessibilityHelp |
AccessibleObject がユーザー補助アプリケーションにヘルプを提供したときに発生します。 (継承元 Control) |
| QueryContinueDrag |
ドラッグ アンド ドロップ操作中に発生し、ドラッグ ソースがドラッグ アンド ドロップ操作をキャンセルする必要があるかどうかを決定できるようにします。 (継承元 Control) |
| RegionChanged |
Region プロパティの値が変化したときに発生します。 (継承元 Control) |
| Resize |
コントロールのサイズが変更されると発生します。 (継承元 Control) |
| RightToLeftChanged |
RightToLeft プロパティの値が変化すると発生します。 (継承元 Control) |
| Scroll |
ユーザーまたはコードによってクライアント領域がスクロールされたときに発生します。 (継承元 ScrollableControl) |
| SizeChanged |
Size プロパティの値が変化すると発生します。 (継承元 Control) |
| StyleChanged |
コントロール スタイルが変更されると発生します。 (継承元 Control) |
| SystemColorsChanged |
システム カラーが変更されると発生します。 (継承元 Control) |
| TabIndexChanged |
TabIndex プロパティの値が変化すると発生します。 (継承元 Control) |
| TabStopChanged |
TabStop プロパティの値が変化すると発生します。 (継承元 Control) |
| TextChanged |
TextChanged イベントを発生させます。 |
| Validated |
コントロールの検証が終了すると発生します。 (継承元 Control) |
| Validating |
コントロールが検証しているときに発生します。 (継承元 Control) |
| VisibleChanged |
Visible プロパティの値が変化すると発生します。 (継承元 Control) |
明示的なインターフェイスの実装
| IContainerControl.ActivateControl(Control) |
指定したコントロールをアクティブにします。 (継承元 ContainerControl) |
| IDropTarget.OnDragDrop(DragEventArgs) |
DragDrop イベントを発生させます。 (継承元 Control) |
| IDropTarget.OnDragEnter(DragEventArgs) |
DragEnter イベントを発生させます。 (継承元 Control) |
| IDropTarget.OnDragLeave(EventArgs) |
DragLeave イベントを発生させます。 (継承元 Control) |
| IDropTarget.OnDragOver(DragEventArgs) |
DragOver イベントを発生させます。 (継承元 Control) |
適用対象
こちらもご覧ください
.NET