ListView.AfterLabelEdit Evento

Definición

Espacio de nombres:

System.Windows.Forms

Ensamblado:

System.Windows.Forms.dll

Se produce cuando el usuario edita la etiqueta de un elemento.

public:
 event System::Windows::Forms::LabelEditEventHandler ^ AfterLabelEdit;

public event System.Windows.Forms.LabelEditEventHandler? AfterLabelEdit;

member this.AfterLabelEdit : System.Windows.Forms.LabelEditEventHandler 

Public Custom Event AfterLabelEdit As LabelEditEventHandler 

Tipo de evento

LabelEditEventHandler

Ejemplos

En el ejemplo de código siguiente se muestra cómo usar el AfterLabelEdit evento para restringir una etiqueta recién editada a los caracteres del alfabeto. En el ejemplo se usa la ASCIIEncoding clase para obtener el código de caracteres ASCII de cada carácter de la nueva etiqueta. Si el carácter está entre los códigos ASCII que representan números, no se puede aplicar la nueva etiqueta al elemento. En este ejemplo se requiere que haya creado un ListView control en un formulario y agregado elementos a él. El ejemplo también requiere que haya conectado el AfterLabelEdit evento al controlador de eventos definido en el código de ejemplo. Para usar la clase , el ASCIIEncoding archivo debe incluir el System.Text espacio de nombres .

private:
   void MyListView_AfterLabelEdit( Object^ /*sender*/, System::Windows::Forms::LabelEditEventArgs^ e )
   {
      // Determine if label is changed by checking for 0.
      if ( e->Label == nullptr )
               return;

      // ASCIIEncoding is used to determine if a number character has been entered.
      ASCIIEncoding^ AE = gcnew ASCIIEncoding;

      // Convert the new label to a character array.
      array<Char>^temp = e->Label->ToCharArray();

      // Check each character in the new label to determine if it is a number.
      for ( int x = 0; x < temp->Length; x++ )
      {
         // Encode the character from the character array to its ASCII code.
         array<Byte>^bc = AE->GetBytes( temp[ x ].ToString() );

         // Determine if the ASCII code is within the valid range of numerical values.
         if ( bc[ 0 ] > 47 && bc[ 0 ] < 58 )
         {
            // Cancel the event and return the lable to its original state.
            e->CancelEdit = true;

            // Display a MessageBox alerting the user that numbers are not allowed.
            MessageBox::Show( "The text for the item cannot contain numerical values." );

            // Break out of the loop and exit.
            return;
         }
      }
   }

private void MyListView_AfterLabelEdit(object sender, System.Windows.Forms.LabelEditEventArgs e)
{
 
   // Determine if label is changed by checking for null.
   if (e.Label == null)
      return;

   // ASCIIEncoding is used to determine if a number character has been entered.
   ASCIIEncoding AE = new ASCIIEncoding();
   // Convert the new label to a character array.
   char[] temp = e.Label.ToCharArray();

   // Check each character in the new label to determine if it is a number.
   for(int x=0; x < temp.Length; x++)
   {
      // Encode the character from the character array to its ASCII code.
      byte[] bc = AE.GetBytes(temp[x].ToString());
   
      // Determine if the ASCII code is within the valid range of numerical values.
      if(bc[0] > 47 && bc[0] < 58)
      {
         // Cancel the event and return the lable to its original state.
         e.CancelEdit = true;
         // Display a MessageBox alerting the user that numbers are not allowed.
         MessageBox.Show ("The text for the item cannot contain numerical values.");
         // Break out of the loop and exit.
         return;
      }
   }
}

Private Sub MyListView_AfterLabelEdit(ByVal sender As Object, ByVal e As System.Windows.Forms.LabelEditEventArgs) Handles listView1.AfterLabelEdit

   ' Determine if label is changed by checking to see if it is equal to Nothing.
   If e.Label Is Nothing Then
      Return
   End If
   ' ASCIIEncoding is used to determine if a number character has been entered.
   Dim AE As New ASCIIEncoding()
   ' Convert the new label to a character array.
   Dim temp As Char() = e.Label.ToCharArray()

   ' Check each character in the new label to determine if it is a number.
   Dim x As Integer
   For x = 0 To temp.Length - 1
      ' Encode the character from the character array to its ASCII code.
      Dim bc As Byte() = AE.GetBytes(temp(x).ToString())

      ' Determine if the ASCII code is within the valid range of numerical values.
      If bc(0) > 47 And bc(0) < 58 Then
         ' Cancel the event and return the lable to its original state.
         e.CancelEdit = True
         ' Display a MessageBox alerting the user that numbers are not allowed.
         MessageBox.Show("The text for the item cannot contain numerical values.")
         ' Break out of the loop and exit.
         Return
      End If
   Next x
End Sub

Comentarios

El AfterLabelEdit evento se produce cuando el usuario termina de modificar el texto de un elemento. La nueva cadena que el usuario escribe para el elemento se pasa al evento y el controlador de eventos puede rechazar el cambio. Si el controlador de eventos rechaza el cambio, el texto se revierte al texto tal y como estaba antes de que el usuario empezara a editar el elemento.

Nota

Dado que el ListView.AfterLabelEdit evento tiene lugar antes de confirmar la edición de etiquetas, al llamar al ListView.Sort método en un controlador para este evento se ordenará el elemento con el valor original.

Para que se genere el AfterLabelEdit evento, la LabelEdit propiedad del ListView control debe establecerse trueen .

Puede crear un controlador de eventos para que el BeforeLabelEdit evento realice tareas antes de que el usuario edite el texto de un elemento.

Para obtener más información sobre el manejo de eventos, consulte controlar y provocar eventos.

Consulte también

• OnAfterLabelEdit(LabelEditEventArgs)
• BeforeLabelEdit
• LabelEditEventHandler
• LabelEdit