Control.Enabled 속성

정의

컨트롤이 사용자 상호 작용에 응답할 수 있는지를 나타내는 값을 가져오거나 설정합니다.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.

컨테이너 컨트롤의 enabled 속성이 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. 예를 들어 비활성화 된 여러 줄 텍스트 상자를 스크롤하여 모든 텍스트 줄을 표시할 수는 없습니다.For example, a disabled multiline textbox is unable to scroll to display all the lines of text.

적용 대상

추가 정보