Freigeben über


Console.MoveBufferArea Methode

Definition

Kopiert einen angegebenen Quellbereich des Bildschirmpuffers in einen angegebenen Zielbereich.

Überlädt

MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32)

Kopiert einen angegebenen Quellbereich des Bildschirmpuffers in einen angegebenen Zielbereich.

MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor)

Kopiert einen angegebenen Quellbereich des Bildschirmpuffers in einen angegebenen Zielbereich.

MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Kopiert einen angegebenen Quellbereich des Bildschirmpuffers in einen angegebenen Zielbereich.

public:
 static void MoveBufferArea(int sourceLeft, int sourceTop, int sourceWidth, int sourceHeight, int targetLeft, int targetTop);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void MoveBufferArea (int sourceLeft, int sourceTop, int sourceWidth, int sourceHeight, int targetLeft, int targetTop);
public static void MoveBufferArea (int sourceLeft, int sourceTop, int sourceWidth, int sourceHeight, int targetLeft, int targetTop);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member MoveBufferArea : int * int * int * int * int * int -> unit
static member MoveBufferArea : int * int * int * int * int * int -> unit
Public Shared Sub MoveBufferArea (sourceLeft As Integer, sourceTop As Integer, sourceWidth As Integer, sourceHeight As Integer, targetLeft As Integer, targetTop As Integer)

Parameter

sourceLeft
Int32

Die am weitesten links stehende Spalte des Quellbereichs.

sourceTop
Int32

Die oberste Zeile des Quellbereichs.

sourceWidth
Int32

Die Anzahl der Spalten im Quellbereich.

sourceHeight
Int32

Die Anzahl der Zeilen im Quellbereich.

targetLeft
Int32

Die am weitesten links stehende Spalte des Zielbereichs.

targetTop
Int32

Die oberste Zeile des Zielbereichs.

Attribute

Ausnahmen

Mindestens einer der Parameter ist kleiner als 0 (null).

- oder -

sourceLeft oder targetLeft ist größer oder gleich BufferWidth.

- oder -

sourceTop oder targetTop ist größer oder gleich BufferHeight.

- oder -

sourceTop + sourceHeight ist größer oder gleich BufferHeight.

- oder -

sourceLeft + sourceWidth ist größer oder gleich BufferWidth.

Der Benutzer verfügt nicht über die erforderlichen Berechtigung, um diese Aktion durchzuführen.

E/A-Fehler

Das aktuelle Betriebssystem ist nicht Windows.

Hinweise

Wenn die Ziel- und Quellparameter eine Position angeben, die sich außerhalb der Grenzen des aktuellen Bildschirmpuffers befindet, wird nur der Teil des Quellbereichs kopiert, der in den Zielbereich passt. Das heißt, der Quellbereich wird an den aktuellen Bildschirmpuffer angepasst.

Die MoveBufferArea Methode kopiert den Quellbereich in den Zielbereich. Wenn der Zielbereich den Quellbereich nicht überschneidet, wird der Quellbereich mit Leerzeichen unter Verwendung der aktuellen Vordergrund- und Hintergrundfarben gefüllt. Andernfalls wird der überschneidene Teil des Quellbereichs nicht gefüllt.

Gilt für:

MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor)

Quelle:
Console.cs
Quelle:
Console.cs
Quelle:
Console.cs

Kopiert einen angegebenen Quellbereich des Bildschirmpuffers in einen angegebenen Zielbereich.

public:
 static void MoveBufferArea(int sourceLeft, int sourceTop, int sourceWidth, int sourceHeight, int targetLeft, int targetTop, char sourceChar, ConsoleColor sourceForeColor, ConsoleColor sourceBackColor);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void MoveBufferArea (int sourceLeft, int sourceTop, int sourceWidth, int sourceHeight, int targetLeft, int targetTop, char sourceChar, ConsoleColor sourceForeColor, ConsoleColor sourceBackColor);
public static void MoveBufferArea (int sourceLeft, int sourceTop, int sourceWidth, int sourceHeight, int targetLeft, int targetTop, char sourceChar, ConsoleColor sourceForeColor, ConsoleColor sourceBackColor);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member MoveBufferArea : int * int * int * int * int * int * char * ConsoleColor * ConsoleColor -> unit
static member MoveBufferArea : int * int * int * int * int * int * char * ConsoleColor * ConsoleColor -> unit
Public Shared Sub MoveBufferArea (sourceLeft As Integer, sourceTop As Integer, sourceWidth As Integer, sourceHeight As Integer, targetLeft As Integer, targetTop As Integer, sourceChar As Char, sourceForeColor As ConsoleColor, sourceBackColor As ConsoleColor)

Parameter

sourceLeft
Int32

Die am weitesten links stehende Spalte des Quellbereichs.

sourceTop
Int32

Die oberste Zeile des Quellbereichs.

sourceWidth
Int32

Die Anzahl der Spalten im Quellbereich.

sourceHeight
Int32

Die Anzahl der Zeilen im Quellbereich.

targetLeft
Int32

Die am weitesten links stehende Spalte des Zielbereichs.

targetTop
Int32

Die oberste Zeile des Zielbereichs.

sourceChar
Char

Das zum Ausfüllen des Quellbereichs verwendete Zeichen.

sourceForeColor
ConsoleColor

Die zum Ausfüllen des Quellbereichs verwendete Vordergrundfarbe.

sourceBackColor
ConsoleColor

Die zum Ausfüllen des Quellbereichs verwendete Hintergrundfarbe.

Attribute

Ausnahmen

Mindestens einer der Parameter ist kleiner als 0 (null).

- oder -

sourceLeft oder targetLeft ist größer oder gleich BufferWidth.

- oder -

sourceTop oder targetTop ist größer oder gleich BufferHeight.

- oder -

sourceTop + sourceHeight ist größer oder gleich BufferHeight.

- oder -

sourceLeft + sourceWidth ist größer oder gleich BufferWidth.

Einer oder beide Farbparameter sind kein Member der ConsoleColor-Enumeration.

Der Benutzer verfügt nicht über die erforderlichen Berechtigung, um diese Aktion durchzuführen.

E/A-Fehler

Das aktuelle Betriebssystem ist nicht Windows.

Hinweise

Wenn die Ziel- und Quellparameter eine Position angeben, die sich außerhalb der Grenzen des aktuellen Bildschirmpuffers befindet, wird nur der Teil des Quellbereichs kopiert, der in den Zielbereich passt. Das heißt, der Quellbereich wird an den aktuellen Bildschirmpuffer angepasst.

Die MoveBufferArea Methode kopiert den Quellbereich in den Zielbereich. Wenn der Zielbereich den Quellbereich nicht überschneidet, wird der Quellbereich mit dem von sourceCharangegebenen Zeichen gefüllt, wobei die von sourceForeColor angegebenen Farben verwendet werden sourceBackColor. Andernfalls wird der überschneidene Teil des Quellbereichs nicht gefüllt.

Die MoveBufferArea -Methode führt keinen Vorgang aus, wenn sourceWidth oder sourceHeight null ist.

Gilt für: