LabelEditEventArgs Clase
Definición
Importante
Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
Proporciona datos para los eventos BeforeLabelEdit y AfterLabelEdit.
public ref class LabelEditEventArgs : EventArgs
public class LabelEditEventArgs : EventArgs
type LabelEditEventArgs = class
inherit EventArgs
Public Class LabelEditEventArgs
Inherits EventArgs
- Herencia
Ejemplos
En el ejemplo de código siguiente se muestra cómo controlar el ListView.BeforeLabelEdit evento y usar las Item propiedades y CancelEdit . Para ejecutar el ejemplo, pegue el código siguiente en un formulario que contiene un ListView control denominado ListView1
y rellenado con al menos 3 elementos. Asegúrese de que todos los eventos están asociados a sus métodos de control de eventos.
void ListView1_BeforeLabelEdit( Object^ sender,
System::Windows::Forms::LabelEditEventArgs^ e )
{
// Allow all but the first two items of the list to
// be modified by the user.
if ( e->Item < 2 )
{
e->CancelEdit = true;
}
}
private void ListView1_BeforeLabelEdit(object sender,
System.Windows.Forms.LabelEditEventArgs e)
{
// Allow all but the first two items of the list to
// be modified by the user.
if (e.Item<2)
{
e.CancelEdit = true;
}
}
Private Sub ListView1_BeforeLabelEdit(ByVal sender As Object, _
ByVal e As System.Windows.Forms.LabelEditEventArgs) _
Handles ListView1.BeforeLabelEdit
' Allow all but the first two items of the list to be modified by
' the user.
If (e.Item < 2) Then
e.CancelEdit = True
End If
End Sub
Comentarios
un LabelEditEventArgs objeto especifica el índice y subtítulo de y ListViewItem la subtítulo después de que el usuario la haya editado. Esta clase también proporciona una CancelEdit propiedad . Puede usar esta propiedad en un ListView.BeforeLabelEdit controlador de eventos para impedir que el usuario edite la etiqueta. También puede usarlo en un ListView.AfterLabelEdit controlador de eventos para revertir el cambio, devolviendo la etiqueta a su valor original. Esto resulta útil cuando desea validar la entrada del usuario antes de confirmar el cambio.
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.
Constructores
LabelEditEventArgs(Int32) |
Inicializa una nueva instancia de la clase LabelEditEventArgs con el índice especificado en el ListViewItem que se va a editar. |
LabelEditEventArgs(Int32, String) |
Inicializa una nueva instancia de la clase LabelEditEventArgs con el índice especificado en el ListViewItem que está editando y el nuevo texto para la etiqueta de ListViewItem. |
Propiedades
CancelEdit |
Obtiene o establece un valor que indica si los cambios realizados en la etiqueta de ListViewItem deben cancelarse. |
Item |
Obtiene el índice de base cero de ListViewItem, que contiene la etiqueta que se va a editar. |
Label |
Obtiene el nuevo texto asignado a la etiqueta de ListViewItem. |
Métodos
Equals(Object) |
Determina si el objeto especificado es igual que el objeto actual. (Heredado de Object) |
GetHashCode() |
Sirve como la función hash predeterminada. (Heredado de Object) |
GetType() |
Obtiene el Type de la instancia actual. (Heredado de Object) |
MemberwiseClone() |
Crea una copia superficial del Object actual. (Heredado de Object) |
ToString() |
Devuelve una cadena que representa el objeto actual. (Heredado de Object) |