Control.LostFocus 事件
定义
重要
一些信息与预发行产品相关，相应产品在发行之前可能会进行重大修改。 对于此处提供的信息，Microsoft 不作任何明示或暗示的担保。
在控件失去焦点时发生。
public:
event EventHandler ^ LostFocus;[System.ComponentModel.Browsable(false)]
public event EventHandler LostFocus;[System.ComponentModel.Browsable(false)]
public event EventHandler? LostFocus;[<System.ComponentModel.Browsable(false)>]
member this.LostFocus : EventHandler Public Custom Event LostFocus As EventHandler 事件类型
- 属性
示例
下面的代码示例演示如何验证 TextBox1 的文本。 它还演示了通过将 属性设置为 FileDialog.InitialDirectory TextBox1 中的文本来处理LostFocus事件。 代码示例使用 ErrorProvider.GetError 方法在打开文件对话框之前检查错误。 若要运行此示例，请将以下代码粘贴到包含TextBox名为 、名为 TextBox1OpenFileDialog1、ButtonOpenFileDialog名为 Button1和 ErrorProvider 的窗体中ErrorProvider1。 确保所有事件都与其事件处理程序相关联。
private:
void TextBox1_Validating( Object^ sender,
System::ComponentModel::CancelEventArgs^ e )
{
// If nothing is entered,
// an ArgumentException is caught; if an invalid directory is entered,
// a DirectoryNotFoundException is caught. An appropriate error message
// is displayed in either case.
try
{
System::IO::DirectoryInfo^ directory = gcnew System::IO::DirectoryInfo( TextBox1->Text );
directory->GetFiles();
ErrorProvider1->SetError( TextBox1, "" );
}
catch ( System::ArgumentException^ )
{
ErrorProvider1->SetError( TextBox1, "Please enter a directory" );
}
catch ( System::IO::DirectoryNotFoundException^ )
{
ErrorProvider1->SetError( TextBox1, "The directory does not exist."
"Try again with a different directory." );
}
}
// This method handles the LostFocus event for TextBox1 by setting the
// dialog's InitialDirectory property to the text in TextBox1.
void TextBox1_LostFocus( Object^ sender, System::EventArgs^ e )
{
OpenFileDialog1->InitialDirectory = TextBox1->Text;
}
// This method demonstrates using the ErrorProvider.GetError method
// to check for an error before opening the dialog box.
void Button1_Click( System::Object^ sender, System::EventArgs^ e )
{
//If there is no error, then open the dialog box.
if ( ErrorProvider1->GetError( TextBox1 )->Equals( "" ) )
{
::DialogResult dialogResult = OpenFileDialog1->ShowDialog();
}
}
private void textBox1_Validating(object sender,
System.ComponentModel.CancelEventArgs e)
{
// If nothing is entered,
// an ArgumentException is caught; if an invalid directory is entered,
// a DirectoryNotFoundException is caught. An appropriate error message
// is displayed in either case.
try
{
System.IO.DirectoryInfo directory =
new System.IO.DirectoryInfo(textBox1.Text);
directory.GetFiles();
errorProvider1.SetError(textBox1, "");
}
catch(System.ArgumentException ex1)
{
errorProvider1.SetError(textBox1, "Please enter a directory");
}
catch(System.IO.DirectoryNotFoundException ex2)
{
errorProvider1.SetError(textBox1, "The directory does not exist." +
"Try again with a different directory.");
}
}
// This method handles the LostFocus event for textBox1 by setting the
// dialog's InitialDirectory property to the text in textBox1.
private void textBox1_LostFocus(object sender, System.EventArgs e)
{
openFileDialog1.InitialDirectory = textBox1.Text;
}
// This method demonstrates using the ErrorProvider.GetError method
// to check for an error before opening the dialog box.
private void button1_Click(System.Object sender, System.EventArgs e)
{
//If there is no error, then open the dialog box.
if (errorProvider1.GetError(textBox1)=="")
{
DialogResult dialogResult = openFileDialog1.ShowDialog();
}
}
Private Sub TextBox1_Validating(ByVal sender As Object, _
ByVal e As System.ComponentModel.CancelEventArgs) _
Handles TextBox1.Validating
' If nothing is entered,
' an ArgumentException is caught; if an invalid directory is entered,
' a DirectoryNotFoundException is caught. An appropriate error message
' is displayed in either case.
Try
Dim directory As New System.IO.DirectoryInfo(TextBox1.Text)
directory.GetFiles()
ErrorProvider1.SetError(TextBox1, "")
Catch ex1 As System.ArgumentException
ErrorProvider1.SetError(TextBox1, "Please enter a directory")
Catch ex2 As System.IO.DirectoryNotFoundException
ErrorProvider1.SetError(TextBox1, _
"The directory does not exist." & _
"Try again with a different directory.")
End Try
End Sub
' This method handles the LostFocus event for TextBox1 by setting the
' dialog's InitialDirectory property to the text in TextBox1.
Private Sub TextBox1_LostFocus(ByVal sender As Object, _
ByVal e As System.EventArgs) Handles TextBox1.LostFocus
OpenFileDialog1.InitialDirectory = TextBox1.Text
End Sub
' This method demonstrates using the ErrorProvider.GetError method
' to check for an error before opening the dialog box.
Private Sub Button1_Click(ByVal sender As System.Object, _
ByVal e As System.EventArgs) Handles Button1.Click
'If there is no error, then open the dialog box.
If ErrorProvider1.GetError(TextBox1) = "" Then
Dim dialogResult As DialogResult = OpenFileDialog1.ShowDialog()
End If
End Sub
注解
通过使用键盘 (TAB、SHIFT+TAB 等) 、调用 Select 或 SelectNextControl 方法或将 属性设置为 ContainerControl.ActiveControl 当前窗体来更改焦点时，焦点事件按以下顺序发生：
使用鼠标或调用 Focus 方法更改焦点时，焦点事件按以下顺序发生：
如果 属性 CausesValidation 设置为 false， Validating 则取消和 Validated 事件。
Cancel如果在事件委托中Validating将 的 CancelEventArgs 属性设置为 true ，则通常会在事件后Validating发生的所有事件都会被禁止显示。
注意
GotFocus和 LostFocus 事件是低级别焦点事件，与WM_KILLFOCUS和WM_SETFOCUS Windows 消息相关联。 通常， GotFocus 和 LostFocus 事件仅在更新 UICues 或编写自定义控件时使用。 相反， Enter 和 Leave 事件应用于除 类之外 Form 的所有控件，该类使用 Activated 和 Deactivate 事件。 有关 和 LostFocus 事件的详细信息GotFocus，请参阅WM_KILLFOCUS和WM_KILLFOCUS主题。
注意
不要尝试从 、、GotFocus、ValidatingLeaveLostFocus、 或 Validated 事件处理程序中Enter设置焦点。 这样做可能会导致应用程序或操作系统停止响应。 有关详细信息，请参阅 WM_KILLFOCUS 主题。
有关处理事件的详细信息，请参阅 处理和引发事件。
