Partilhar via


ItemCheckEventArgs.NewValue Propriedade

Definição

Obtém ou define um valor que indica se é necessário marcar, desmarcar ou deixar indeterminada a caixa de seleção para o item.

public:
 property System::Windows::Forms::CheckState NewValue { System::Windows::Forms::CheckState get(); void set(System::Windows::Forms::CheckState value); };
public System.Windows.Forms.CheckState NewValue { get; set; }
member this.NewValue : System.Windows.Forms.CheckState with get, set
Public Property NewValue As CheckState

Valor da propriedade

Um dos valores de CheckState.

Exemplos

O exemplo de código a seguir demonstra o uso desse membro. No exemplo, um manipulador de eventos relata a ocorrência do CheckedListBox.ItemCheck evento. Este relatório ajuda você a saber quando o evento ocorre e pode ajudá-lo na depuração. Para relatar vários eventos ou eventos que ocorrem com frequência, considere substituir MessageBox.ShowConsole.WriteLine por ou acrescentar a mensagem a uma multilinha TextBox.

Para executar o código de exemplo, cole-o em um projeto que contém uma instância do tipo CheckedListBox chamada CheckedListBox1. Em seguida, verifique se o manipulador de eventos está associado ao CheckedListBox.ItemCheck evento.

private void CheckedListBox1_ItemCheck(Object sender, ItemCheckEventArgs e) {

System.Text.StringBuilder messageBoxCS = new System.Text.StringBuilder();
messageBoxCS.AppendFormat("{0} = {1}", "Index", e.Index );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "NewValue", e.NewValue );
messageBoxCS.AppendLine();
messageBoxCS.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue );
messageBoxCS.AppendLine();
MessageBox.Show(messageBoxCS.ToString(), "ItemCheck Event" );
}
Private Sub CheckedListBox1_ItemCheck(sender as Object, e as ItemCheckEventArgs) _ 
     Handles CheckedListBox1.ItemCheck

    Dim messageBoxVB as New System.Text.StringBuilder()
    messageBoxVB.AppendFormat("{0} = {1}", "Index", e.Index)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "NewValue", e.NewValue)
    messageBoxVB.AppendLine()
    messageBoxVB.AppendFormat("{0} = {1}", "CurrentValue", e.CurrentValue)
    messageBoxVB.AppendLine()
    MessageBox.Show(messageBoxVB.ToString(),"ItemCheck Event")

End Sub

Comentários

Essa propriedade permite que você determine o novo estado de marcar para o item especificado antes que o estado de marcar seja alterado pelo CheckedListBox controle . Além de determinar o novo estado de marcar, você pode usar essa propriedade em um manipulador de eventos para o ItemCheck evento para alterar o estado para um estado de marcar diferente do especificado. Por exemplo, se o usuário colocou uma marca de marcar ao lado de um item no CheckedListBox que você determinou que não deve ser verificado com base no estado do seu aplicativo, você pode substituir a alteração no estado de marca marcar definindo essa propriedade como sua configuração anterior ou com um estado de marcar diferente.

Aplica-se a

Confira também