Spread Windows Forms 6.0 Product Documentation
Focus(Boolean) Method
See Also  Example Support Options
FarPoint.Win Assembly > FarPoint.Win Namespace > ElementControl Class > Focus Method : Focus(Boolean) Method


giveFocus
Whether to move focus to the control

Glossary Item Box

Moves the focus to the control.

Syntax

Visual Basic (Declaration) 
Public Overloads Overridable Sub Focus( _
   ByVal giveFocus As Boolean _
) 
Visual Basic (Usage)Copy Code
Dim instance As ElementControl
Dim giveFocus As Boolean
 
instance.Focus(giveFocus)
C# 
public virtual void Focus( 
   bool giveFocus
)

Parameters

giveFocus
Whether to move focus to the control

Remarks

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.

Example

This example shows the use of this member.
C#Copy Code
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 BasicCopy Code
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()

Requirements

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

See Also

© 2002-2012 ComponentOne, a division of GrapeCity. All Rights Reserved.