Focus(Boolean) Method

Visual Basic
C#

'Declaration
 
Public Overloads Overridable Sub Focus( _
   ByVal giveFocus As Boolean _
)

'Usage
 
Dim instance As ElementControl
Dim giveFocus As Boolean
 
instance.Focus(giveFocus)

public virtual void Focus( 
   bool giveFocus
)

Parameters

giveFocus: Whether to move focus to the control

Use this method to move the focus to or remove the focus from the control. Use the Focus method if you want to move the focus to the control and receive a return value whether moving the focus was successful.

If you try to move the focus to the control by using this method, but the CanFocus property or the Enabled property is set to false, the focus will not move to the control.

You can check whether the control already has the focus using the Focused property.

For some controls, when the control receives the focus, if it can, the control can display a focus rectangle. Specify whether and how the focus rectangle appears by setting the DrawFocusRectangle property.

Some controls display a cursor when they receive the focus. Specify the position of the cursor by setting the EditModeCursorPosition property, if supported.

This example shows the use of this member.

C#

control.Text = "NO SMOKING";
control.ForeColor = Color.Red;
control.TextOrientation = FarPoint.Win.TextOrientation.TextVertical;
control.Picture = Image.FromFile(Application.StartupPath + "\\smokes.bmp", true)
control.AlignText = FarPoint.Win.TextAlign.TextLeftPictRight;
control.AlignHorz = FarPoint.Win.HorizontalAlignment.Center;
Rectangle rect = new Rectangle(10,50,200,150);
control.SetBounds(rect);
control.Focus();

Visual Basic

control.Text = "NO SMOKING"
control.ForeColor = Color.Red
control.TextOrientation = FarPoint.Win.TextOrientation.TextVertical
control.Picture = Image.FromFile(Application.StartupPath & "\smokes.bmp", True)
control.AlignText = FarPoint.Win.TextAlign.TextLeftPictRight
control.AlignHorz = FarPoint.Win.HorizontalAlignment.Center
Dim rect As New Rectangle(10, 50, 200, 150)
control.SetBounds(rect)
control.Focus()

Target Platforms: Windows 2000 Professional (SP4), Windows 2000 Server, Windows 2003 Server (SP1), Windows 2008, Windows XP (SP2), Windows Vista, Windows 7, Windows 8

Reference

ElementControl Class
ElementControl Members
Overload List
CanFocus Property
Enabled Property
DrawFocusRectangle Property
EditModeCursorPosition Property
Focused Property