Control.LostFocus Esemény
Definíció
Fontos
Egyes információk olyan, kiadás előtti termékekre vonatkoznak, amelyek a kiadásig még jelentősen módosulhatnak. A Microsoft nem vállal kifejezett vagy törvényi garanciát az itt megjelenő információért.
Akkor fordul elő, ha a vezérlő elveszíti a fókuszt.
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
Eseménytípus
- Attribútumok
Példák
Az alábbi példakód bemutatja a TextBox1 szövegének érvényesítését. Azt is bemutatja az esemény kezelését, LostFocus ha a FileDialog.InitialDirectory tulajdonságot a TextBox1 szövegére állítja. A példakód a ErrorProvider.GetError fájl párbeszédpanel megnyitása előtt a hiba keresésére használt metódust használta. A példa futtatásához illessze be a következő kódot egy elnevezett, egy TextBox elnevezettTextBox1, egy OpenFileDialog elnevezett OpenFileDialog1és egy Button elnevezett Button1űrlapot tartalmazó ErrorProvider űrlapba.ErrorProvider1 Győződjön meg arról, hogy minden esemény társítva van az eseménykezelőkkel.
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
Megjegyzések
Ha a billentyűzettel (TAB, SHIFT+TAB stb.) módosítja a fókuszt, meghívja a SelectSelectNextControl metódusokat, vagy a ContainerControl.ActiveControl tulajdonságot az aktuális űrlapra állítja, a fókuszesemények a következő sorrendben következnek be:
Ha az egérrel vagy a Focus metódus meghívásával módosítja a fókuszt, a fókuszesemények a következő sorrendben következnek be:
Ha a CausesValidation tulajdonság értéke a következő, falseaz események és Validating az Validated események el lesznek tiltva.
Ha a Cancel tulajdonság értéke az CancelEventArgs eseménymegbízottban van beállítvatrue, a rendszer minden olyan eseményt letilt, amely általában az esemény elnyomása ValidatingValidating után következik be.
Note
A GotFocus és LostFocus események alacsony szintű fókuszesemények, amelyek a WM_KILLFOCUS és WM_SETFOCUS Windows üzenetekhez vannak kötve. Az eseményeket és GotFocus az LostFocus eseményeket általában csak az egyéni vezérlők frissítésekor UICues vagy írásakor használják. Ehelyett az és az EnterLeave eseményeket az osztály kivételével Form minden vezérlőhöz használni kell, amely az és Activated az Deactivate eseményeket használja. Az eseményekkel kapcsolatos további információkért GotFocusLostFocus tekintse meg a WM_KILLFOCUS és WM_KILLFOCUS témaköröket.
Figyelmeztetés
Ne próbálja meg beállítani a fókuszt a Enter, GotFocus, , Leave, LostFocus, Validatingvagy Validated eseménykezelőkből. Ez azt eredményezheti, hogy az alkalmazás vagy az operációs rendszer nem válaszol. További információ: WM_KILLFOCUS témakör.
Az események kezelésével kapcsolatos további információkért lásd : Események kezelése és emelése.