Control.Enabled Control.Enabled Control.Enabled Control.Enabled Property

정의

컨트롤이 사용자 상호 작용에 응답할 수 있는지를 나타내는 값을 가져오거나 설정합니다.Gets or sets a value indicating whether the control can respond to user interaction.

public:
 property bool Enabled { bool get(); void set(bool value); };
public bool Enabled { get; set; }
member this.Enabled : bool with get, set
Public Property Enabled As Boolean

속성 값

컨트롤이 사용자 상호 작용에 응답할 수 있으면 true이고, 그렇지 않으면 false입니다.true if the control can respond to user interaction; otherwise, false. 기본값은 true입니다.The default is true.

예제

다음 코드 예제는 GroupBox 해당 공용 속성 중 일부를 설정 합니다.The following code example creates a GroupBox and sets some of its common properties. 이 예에서는 만듭니다는 TextBox 설정 및 해당 Location 그룹 상자 내에서.The example creates a TextBox and sets its Location within the group box. 그런 다음 설정의 Text 그룹 상자 및 폼의 위쪽에 도킹 된 그룹 상자는 속성입니다.Next, it sets the Text property of the group box, and docks the group box to the top of the form. 마지막으로, 그룹 상자를 설정 하 여 비활성화 된 Enabled 속성을 false, 사용 하지 않도록 설정할 그룹 상자 내에 포함 된 모든 컨트롤에 이르게 합니다.Lastly, it disables the group box by setting the Enabled property to false, which causes all controls contained within the group box to be disabled.

   // Add a GroupBox to a form and set some of its common properties.
private:
   void AddMyGroupBox()
   {
      // Create a GroupBox and add a TextBox to it.
      GroupBox^ groupBox1 = gcnew GroupBox;
      TextBox^ textBox1 = gcnew TextBox;
      textBox1->Location = Point(15,15);
      groupBox1->Controls->Add( textBox1 );

      // Set the Text and Dock properties of the GroupBox.
      groupBox1->Text = "MyGroupBox";
      groupBox1->Dock = DockStyle::Top;

      // Disable the GroupBox (which disables all its child controls)
      groupBox1->Enabled = false;

      // Add the Groupbox to the form.
      this->Controls->Add( groupBox1 );
   }
// Add a GroupBox to a form and set some of its common properties.
private void AddMyGroupBox()
{
   // Create a GroupBox and add a TextBox to it.
   GroupBox groupBox1 = new GroupBox();
   TextBox textBox1 = new TextBox();
   textBox1.Location = new Point(15, 15);
   groupBox1.Controls.Add(textBox1);

   // Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox";
   groupBox1.Dock = DockStyle.Top;

   // Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = false;

   // Add the Groupbox to the form.
   this.Controls.Add(groupBox1);
}
' Add a GroupBox to a form and set some of its common properties.
Private Sub AddMyGroupBox()
   ' Create a GroupBox and add a TextBox to it.
   Dim groupBox1 As New GroupBox()
   Dim textBox1 As New TextBox()
   textBox1.Location = New Point(15, 15)
   groupBox1.Controls.Add(textBox1)
   
   ' Set the Text and Dock properties of the GroupBox.
   groupBox1.Text = "MyGroupBox"
   groupBox1.Dock = DockStyle.Top
   
   ' Disable the GroupBox (which disables all its child controls)
   groupBox1.Enabled = False
   
   ' Add the Groupbox to the form.
   Me.Controls.Add(groupBox1)
End Sub

설명

사용 하 여는 Enabled 속성을 런타임에 컨트롤을 사용 하지 않도록 설정 하거나 설정할 수 있습니다.With the Enabled property, you can enable or disable controls at run time. 예를 들어, 응용 프로그램의 현재 상태에 적용 되지 않는 컨트롤을 비활성화할 수 있습니다.For example, you can disable controls that do not apply to the current state of the application. 또한 해당 사용을 제한 하기 위한 컨트롤을 비활성화할 수 있습니다.You can also disable a control to restrict its use. 예를 들어 사용자가 클릭 하지 않도록 하려면 단추를 해제할 수 있습니다.For example, a button can be disabled to prevent the user from clicking it. 컨트롤을 사용 하지 않도록 설정 하는 경우에 선택할 수 없습니다.If a control is disabled, it cannot be selected.

중요

설정 된 Enabled 속성을 false 응용 프로그램의 컨트롤 상자를 사용 하지 않도록 설정 하거나 응용 프로그램 창에서 포커스를 받을 방지 하지 않습니다.Setting the Enabled property to false does not disable the application's control box or prevent the application window from receiving the focus.

컨테이너 컨트롤의 해당 활성화 속성이 설정 된 경우 false, 포함 된 모든 컨트롤도 비활성화 됩니다.When a container control has its enabled property set to false, all its contained controls are disabled, as well. 예를 들어, 사용자가 사용 되지 않는 포함 된 컨트롤 중 하나를 클릭 하면 GroupBox 제어 이벤트가 발생 하지 않습니다.For example, if the user clicks on any of the controls contained in a disabled GroupBox control, no events are raised.

참고

스크롤할 수 있는 컨트롤을 사용 하지 않도록 설정 하는 경우 스크롤 막대 조건도 비활성화 됩니다.When a scrollable control is disabled, the scroll bars are also disabled. 예를 들어, 비활성화 된 여러 줄 textbox 텍스트의 모든 줄에 표시할 스크롤할 수 아닙니다.For example, a disabled multiline textbox is unable to scroll to display all the lines of text.

적용 대상

추가 정보