Control::Focused Property

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Gets a value indicating whether the control has input focus.

Namespace:   System.Windows.Forms
Assembly:  System.Windows.Forms (in System.Windows.Forms.dll)

public:
[BrowsableAttribute(false)]
property bool Focused {
	virtual bool get();
}

Property Value

Type: System::Boolean

true if the control has focus; otherwise, false.

Notes to Inheritors:

When overriding the Focused property in a derived class, use the base class's Focused property to extend the base implementation. Otherwise, you must provide all the implementation.

The following code example disables a MenuItem if a TextBox does not have focus. This example requires that you have a Form with a TextBox named textBox1 and two MenuItem objects named menuItemEdit and menuItemEditInsertCustomerInfo.

private:
   void menuItemEdit_Popup( Object^ /*sender*/, EventArgs^ /*e*/ )
   {
      // Disable the menu item if the text box does not have focus.
      this->menuItemEditInsertCustomerInfo->Enabled = this->textBox1->Focused;
   }

.NET Framework
Available since 1.1
Return to top
Show: