Console.SetCursorPosition(Int32, Int32) Methode

Definition

Namespace:
System
Assembly:
mscorlib.dll
Assembly:
System.Console.dll
Assembly:
netstandard.dll

Legt die Position des Cursors fest.

public:
 static void SetCursorPosition(int left, int top);
public static void SetCursorPosition(int left, int top);
static member SetCursorPosition : int * int -> unit
Public Shared Sub SetCursorPosition (left As Integer, top As Integer)

Parameter

left
Int32

Die Spaltenposition des Cursors. Spalten werden von links nach rechts nummeriert, beginnend bei 0.

top
Int32

Die Zeilenposition des Cursors. Zeilen werden von oben nach unten nummeriert, beginnend bei 0.

Ausnahmen

ArgumentOutOfRangeException

left oder top ist kleiner als Null.

-oder-

left ist größer oder gleich BufferWidth.

-oder-

top ist größer oder gleich BufferHeight.

SecurityException

Der Benutzer besitzt keine Berechtigung zum Ausführen dieser Aktion.

IOException

Ein E/A-Fehler ist aufgetreten.

Beispiele

In diesem Beispiel werden die CursorLeft Eigenschaften und CursorTop die SetCursorPosition Methoden veranschaulicht Clear . Im Beispiel wird der Cursor positioniert, der bestimmt, wo der nächste Schreibvorgang erfolgt, um ein 5-stelliges Rechteck mit einer Kombination aus "+", "|" und "-" Zeichenfolgen zu zeichnen. Beachten Sie, dass das Rechteck mit weniger Schritten mit einer Kombination aus anderen Zeichenfolgen gezeichnet werden kann.

// This example demonstrates the
//     Console.CursorLeft and
//     Console.CursorTop properties, and the
//     Console.SetCursorPosition and
//     Console.Clear methods.
using System;

class Sample
{
    protected static int origRow;
    protected static int origCol;

    protected static void WriteAt(string s, int x, int y)
    {
    try
        {
        Console.SetCursorPosition(origCol+x, origRow+y);
        Console.Write(s);
        }
    catch (ArgumentOutOfRangeException e)
        {
        Console.Clear();
        Console.WriteLine(e.Message);
        }
    }

    public static void Main()
    {
// Clear the screen, then save the top and left coordinates.
    Console.Clear();
    origRow = Console.CursorTop;
    origCol = Console.CursorLeft;

// Draw the left side of a 5x5 rectangle, from top to bottom.
    WriteAt("+", 0, 0);
    WriteAt("|", 0, 1);
    WriteAt("|", 0, 2);
    WriteAt("|", 0, 3);
    WriteAt("+", 0, 4);

// Draw the bottom side, from left to right.
    WriteAt("-", 1, 4); // shortcut: WriteAt("---", 1, 4)
    WriteAt("-", 2, 4); // ...
    WriteAt("-", 3, 4); // ...
    WriteAt("+", 4, 4);

// Draw the right side, from bottom to top.
    WriteAt("|", 4, 3);
    WriteAt("|", 4, 2);
    WriteAt("|", 4, 1);
    WriteAt("+", 4, 0);

// Draw the top side, from right to left.
    WriteAt("-", 3, 0); // shortcut: WriteAt("---", 1, 0)
    WriteAt("-", 2, 0); // ...
    WriteAt("-", 1, 0); // ...
//
    WriteAt("All done!", 0, 6);
    Console.WriteLine();
    }
}
/*
This example produces the following results:

+---+
|   |
|   |
|   |
+---+

All done!

*/

// This example demonstrates the
//     Console.CursorLeft and
//     Console.CursorTop properties, and the
//     Console.SetCursorPosition and
//     Console.Clear methods.
open System

// Clear the screen, then save the top and left coordinates.
Console.Clear()
let origRow = Console.CursorTop
let origCol = Console.CursorLeft

let writeAt s x y =
    try
        Console.SetCursorPosition(origCol + x, origRow + y)
        printfn $"%s{s}"
    with :? ArgumentOutOfRangeException as e ->
        Console.Clear()
        printfn $"{e.Message}"

// Draw the left side of a 5x5 rectangle, from top to bottom.
writeAt "+" 0 0
writeAt "|" 0 1
writeAt "|" 0 2
writeAt "|" 0 3
writeAt "+" 0 4

// Draw the bottom side, from left to right.
writeAt "-" 1 4 // shortcut: writeAt "---", 1, 4)
writeAt "-" 2 4 // ...
writeAt "-" 3 4 // ...
writeAt "+" 4 4

// Draw the right side, from bottom to top.
writeAt "|" 4 3
writeAt "|" 4 2
writeAt "|" 4 1
writeAt "+" 4 0

// Draw the top side, from right to left.
writeAt "-" 3 0 // shortcut: writeAt "---", 1, 0)
writeAt "-" 2 0 // ...
writeAt "-" 1 0 // ...

writeAt "All done!" 0 6
printfn ""


// This example produces the following results:
//
// +---+
// |   |
// |   |
// |   |
// +---+
//
// All done!

' This example demonstrates the 
'     Console.CursorLeft and 
'     Console.CursorTop properties, and the
'     Console.SetCursorPosition and 
'     Console.Clear methods.
Class Sample
   Protected Shared origRow As Integer
   Protected Shared origCol As Integer
   
   Protected Shared Sub WriteAt(s As String, x As Integer, y As Integer)
      Try
         Console.SetCursorPosition(origCol + x, origRow + y)
         Console.Write(s)
      Catch e As ArgumentOutOfRangeException
         Console.Clear()
         Console.WriteLine(e.Message)
      End Try
   End Sub
   
   Public Shared Sub Main()
      ' Clear the screen, then save the top and left coordinates.
      Console.Clear()
      origRow = Console.CursorTop
      origCol = Console.CursorLeft
      
      ' Draw the left side of a 5x5 rectangle, from top to bottom.
      WriteAt("+", 0, 0)
      WriteAt("|", 0, 1)
      WriteAt("|", 0, 2)
      WriteAt("|", 0, 3)
      WriteAt("+", 0, 4)
      
      ' Draw the bottom side, from left to right.
      WriteAt("-", 1, 4) ' shortcut: WriteAt("---", 1, 4)
      WriteAt("-", 2, 4) ' ...
      WriteAt("-", 3, 4) ' ...
      WriteAt("+", 4, 4)
      
      ' Draw the right side, from bottom to top.
      WriteAt("|", 4, 3)
      WriteAt("|", 4, 2)
      WriteAt("|", 4, 1)
      WriteAt("+", 4, 0)
      
      ' Draw the top side, from right to left.
      WriteAt("-", 3, 0) ' shortcut: WriteAt("---", 1, 0)
      WriteAt("-", 2, 0) ' ...
      WriteAt("-", 1, 0) ' ...
      '
      WriteAt("All done!", 0, 6)
      Console.WriteLine()
   End Sub
End Class
'
'This example produces the following results:
'
'+---+
'|   |
'|   |
'|   |
'+---+
'
'All done!
'

Hinweise

Verwenden Sie die SetCursorPosition Methode, um anzugeben, wo der nächste Schreibvorgang im Konsolenfenster beginnen soll. Wenn sich die angegebene Cursorposition außerhalb des Bereichs befindet, der derzeit im Konsolenfenster sichtbar ist, ändert sich der Fensterursprung automatisch, um den Cursor sichtbar zu machen.

Der Cursor wird jedes Mal automatisch zur nächsten Zeichenposition verschoben, wenn ein Zeichen in das Konsolenfenster geschrieben wird. Wenn sich der Cursor an der unteren rechten Zeichenposition des Konsolenfensters befindet, bewirkt der nächste Schreibvorgang, dass das Konsolenfenster scrollt, sodass der Cursor sichtbar bleibt. Wenn Sie ein Zeichen an die untere rechte Zeichenposition schreiben möchten, ohne dass das Konsolenfenster scrollen muss, verwenden Sie die MoveBufferArea Methode, um ein Zeichen an diese Position zu verschieben.

Gilt für: