ConsoleKeyInfo Struct

Riferimento

Definizione

Spazio dei nomi:: System

Assembly:: System.Console.dll

Assembly:: mscorlib.dll

Assembly:: netstandard.dll

Importante

Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.

Descrive il tasto della console che è stato premuto, oltre al carattere rappresentato dal tasto della console e allo stato dei tasti di modifica MAIUSC, ALT e CTRL.

public value class ConsoleKeyInfo : IEquatable<ConsoleKeyInfo>

public value class ConsoleKeyInfo

public readonly struct ConsoleKeyInfo : IEquatable<ConsoleKeyInfo>

public struct ConsoleKeyInfo

public readonly struct ConsoleKeyInfo

[System.Serializable]
public struct ConsoleKeyInfo

type ConsoleKeyInfo = struct

[<System.Serializable>]
type ConsoleKeyInfo = struct

Public Structure ConsoleKeyInfo
Implements IEquatable(Of ConsoleKeyInfo)

Public Structure ConsoleKeyInfo

Ereditarietà: Object

ValueType
ConsoleKeyInfo

Attributi: SerializableAttribute

Implementazioni: IEquatable<ConsoleKeyInfo>

Esempio

Nell'esempio seguente viene illustrato l'uso di un oggetto in un'operazione ConsoleKeyInfo di lettura.

using namespace System;

void main()
{
   ConsoleKeyInfo cki;
   // Prevent example from ending if CTL+C is pressed.
   Console::TreatControlCAsInput = true;

   Console::WriteLine("Press any combination of CTL, ALT, and SHIFT, and a console key.");
   Console::WriteLine("Press the Escape (Esc) key to quit: \n");
   do 
   {
      cki = Console::ReadKey();
      Console::Write(" --- You pressed ");
      if((cki.Modifiers & ConsoleModifiers::Alt) != ConsoleModifiers()) Console::Write("ALT+");
      if((cki.Modifiers & ConsoleModifiers::Shift) != ConsoleModifiers()) Console::Write("SHIFT+");
      if((cki.Modifiers & ConsoleModifiers::Control) != ConsoleModifiers()) Console::Write("CTL+");
      Console::WriteLine(cki.Key.ToString());
   } while (cki.Key != ConsoleKey::Escape);
}
// This example displays output similar to the following:
//       Press any combination of CTL, ALT, and SHIFT, and a console key.
//       Press the Escape (Esc) key to quit:
//       
//       a --- You pressed A 
//       k --- You pressed ALT+K 
//       ► --- You pressed CTL+P 
//         --- You pressed RightArrow 
//       R --- You pressed SHIFT+R 
//                --- You pressed CTL+I 
//       j --- You pressed ALT+J 
//       O --- You pressed SHIFT+O 
//       § --- You pressed CTL+U }

using System;

class Example
{
   public static void Main()
   {
      ConsoleKeyInfo cki;
      // Prevent example from ending if CTL+C is pressed.
      Console.TreatControlCAsInput = true;

      Console.WriteLine("Press any combination of CTL, ALT, and SHIFT, and a console key.");
      Console.WriteLine("Press the Escape (Esc) key to quit: \n");
      do
      {
         cki = Console.ReadKey();
         Console.Write(" --- You pressed ");
         if((cki.Modifiers & ConsoleModifiers.Alt) != 0) Console.Write("ALT+");
         if((cki.Modifiers & ConsoleModifiers.Shift) != 0) Console.Write("SHIFT+");
         if((cki.Modifiers & ConsoleModifiers.Control) != 0) Console.Write("CTL+");
         Console.WriteLine(cki.Key.ToString());
       } while (cki.Key != ConsoleKey.Escape);
    }
}
// This example displays output similar to the following:
//       Press any combination of CTL, ALT, and SHIFT, and a console key.
//       Press the Escape (Esc) key to quit:
//
//       a --- You pressed A
//       k --- You pressed ALT+K
//       ► --- You pressed CTL+P
//         --- You pressed RightArrow
//       R --- You pressed SHIFT+R
//                --- You pressed CTL+I
//       j --- You pressed ALT+J
//       O --- You pressed SHIFT+O
//       § --- You pressed CTL+U

open System

// Prevent example from ending if CTL+C is pressed.
Console.TreatControlCAsInput <- true

printfn "Press any combination of CTL, ALT, and SHIFT, and a console key."
printfn "Press the Escape (Esc) key to quit: \n"

let mutable cki = Unchecked.defaultof<ConsoleKeyInfo>

while cki.Key <> ConsoleKey.Escape do
    cki <- Console.ReadKey()
    printf " --- You pressed "
    if int (cki.Modifiers &&& ConsoleModifiers.Alt) <> 0 then printf "ALT+"
    if int (cki.Modifiers &&& ConsoleModifiers.Shift) <> 0 then printf "SHIFT+"
    if int (cki.Modifiers &&& ConsoleModifiers.Control) <> 0 then printf "CTL+"
    printfn $"{cki.Key}"


// This example displays output similar to the following:
//       Press any combination of CTL, ALT, and SHIFT, and a console key.
//       Press the Escape (Esc) key to quit:
//
//       a --- You pressed A
//       k --- You pressed ALT+K
//       ► --- You pressed CTL+P
//         --- You pressed RightArrow
//       R --- You pressed SHIFT+R
//                --- You pressed CTL+I
//       j --- You pressed ALT+J
//       O --- You pressed SHIFT+O
//       § --- You pressed CTL+U

Class Example
   Public Shared Sub Main()
      Dim cki As ConsoleKeyInfo
      ' Prevent example from ending if CTL+C is pressed.
      Console.TreatControlCAsInput = True

      Console.WriteLine("Press any combination of CTL, ALT, and SHIFT, and a console key.")
      Console.WriteLine("Press the Escape (Esc) key to quit: " + vbCrLf)
      Do
         cki = Console.ReadKey()
         Console.Write(" --- You pressed ")
         If (cki.Modifiers And ConsoleModifiers.Alt) <> 0 Then Console.Write("ALT+")
         If (cki.Modifiers And ConsoleModifiers.Shift) <> 0 Then Console.Write("SHIFT+")
         If (cki.Modifiers And ConsoleModifiers.Control) <> 0 Then Console.Write("CTL+")
         Console.WriteLine(cki.Key.ToString)
      Loop While cki.Key <> ConsoleKey.Escape
   End Sub 
End Class 
' This example displays output similar to the following:
'       Press any combination of CTL, ALT, and SHIFT, and a console key.
'       Press the Escape (Esc) key to quit:
'       
'       a --- You pressed A 
'       k --- You pressed ALT+K 
'       ► --- You pressed CTL+P 
'         --- You pressed RightArrow 
'       R --- You pressed SHIFT+R 
'                --- You pressed CTL+I 
'       j --- You pressed ALT+J 
'       O --- You pressed SHIFT+O 
'       § --- You pressed CTL+U

Commenti

Il ConsoleKeyInfo tipo non deve essere creato dagli utenti. Viene invece restituito all'utente in risposta alla chiamata al Console.ReadKey metodo.

L'oggetto ConsoleKeyInfo descrive la ConsoleKey costante e il carattere Unicode, se presente, che corrispondono al tasto della console premuto. L'oggetto ConsoleKeyInfo descrive anche, in una combinazione bit per bit di ConsoleModifiers valori, sia che uno o più TASTI MAIUSC, ALT o CTRL siano stati premuti simultaneamente con il tasto console.

Costruttori

ConsoleKeyInfo(Char, ConsoleKey, Boolean, Boolean, Boolean)

Inizializza una nuova istanza della struttura ConsoleKeyInfo utilizzando il carattere, il tasto della console e i tasti di modifica specificati.

Proprietà

Key	Ottiene il tasto della console rappresentato dall'oggetto ConsoleKeyInfo corrente.
KeyChar	Ottiene il carattere Unicode rappresentato dall'oggetto ConsoleKeyInfo corrente.
Modifiers	Ottiene una combinazione bit per bit di valori ConsoleModifiers che specifica uno o più tasti di modifica premuti contemporaneamente al tasto della console.

Metodi

Equals(ConsoleKeyInfo)	Ottiene un valore che indica se l'oggetto ConsoleKeyInfo corrente è uguale all'oggetto ConsoleKeyInfo corrente.
Equals(Object)	Ottiene un valore che indica se l'oggetto specificato è uguale all'oggetto ConsoleKeyInfo corrente.
GetHashCode()	Restituisce il codice hash per l'oggetto ConsoleKeyInfo corrente.

Operatori

Equality(ConsoleKeyInfo, ConsoleKeyInfo)	Indica se gli oggetti ConsoleKeyInfo specificati sono uguali.
Inequality(ConsoleKeyInfo, ConsoleKeyInfo)	Indica se gli oggetti ConsoleKeyInfo specificati non sono uguali.

Si applica a