Console.MoveBufferArea 方法

定义

命名空间:

System

程序集:

System.Console.dll

将屏幕缓冲区的指定源区域复制到指定的目标区域。

重载

MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32)	将屏幕缓冲区的指定源区域复制到指定的目标区域。
MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor)	将屏幕缓冲区的指定源区域复制到指定的目标区域。

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

Source:

Console.cs

将屏幕缓冲区的指定源区域复制到指定的目标区域。

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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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)

参数

sourceLeft

Int32

源区域最左边的列。

sourceTop

Int32

源区域最顶部的行。

sourceWidth

Int32

源区域中列的数目。

sourceHeight

Int32

源区域中行的数目。

targetLeft

Int32

目标区域最左边的列。

targetTop

Int32

目标区域最顶部的行。

属性

SupportedOSPlatformAttribute

例外

ArgumentOutOfRangeException

一个或多个参数小于零。

- 或 -

sourceLeft 或 targetLeft 大于或等于 BufferWidth。

- 或 -

sourceTop 或 targetTop 大于或等于 BufferHeight。

- 或 -

sourceTop + sourceHeight 大于或等于 BufferHeight。

- 或 -

sourceLeft + sourceWidth 大于或等于 BufferWidth。

SecurityException

用户没有执行此操作的权限。

IOException

出现 I/O 错误。

PlatformNotSupportedException

当前操作系统不是 Windows。

注解

如果 destination 和 source 参数指定了位于当前屏幕缓冲区边界之外的位置，则仅复制位于目标区域内的源区域部分。 也就是说，将剪裁源区域以适应当前屏幕缓冲区。

方法 MoveBufferArea 将源区域复制到目标区域。 如果目标区域不与源区域相交，则源区域将使用当前前景色和背景色填充空白。 否则，不会填充源区域的相交部分。

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

Source:

Console.cs

将屏幕缓冲区的指定源区域复制到指定的目标区域。

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);

[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
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)

参数

sourceLeft

Int32

源区域最左边的列。

sourceTop

Int32

源区域最顶部的行。

sourceWidth

Int32

源区域中列的数目。

sourceHeight

Int32

源区域中行的数目。

targetLeft

Int32

目标区域最左边的列。

targetTop

Int32

目标区域最顶部的行。

sourceChar

Char

用于填充源区域的字符。

sourceForeColor

ConsoleColor

用于填充源区域的前景色。

sourceBackColor

ConsoleColor

用于填充源区域的背景色。

属性

SupportedOSPlatformAttribute

例外

ArgumentOutOfRangeException

一个或多个参数小于零。

- 或 -

sourceLeft 或 targetLeft 大于或等于 BufferWidth。

- 或 -

sourceTop 或 targetTop 大于或等于 BufferHeight。

- 或 -

sourceTop + sourceHeight 大于或等于 BufferHeight。

- 或 -

sourceLeft + sourceWidth 大于或等于 BufferWidth。

ArgumentException

一个或两个颜色参数不是 ConsoleColor 枚举的成员。

SecurityException

用户没有执行此操作的权限。

IOException

出现 I/O 错误。

PlatformNotSupportedException

当前操作系统不是 Windows。

注解

如果目标和源参数指定的位置超出了当前屏幕缓冲区的边界，则仅复制位于目标区域内的源区域部分。 也就是说，将剪裁源区域以适应当前屏幕缓冲区。

方法 MoveBufferArea 将源区域复制到目标区域。 如果目标区域不与源区域相交，则源区域将使用 和 指定的颜色来填充由 sourceCharsourceForeColorsourceBackColor指定的字符。 否则，不会填充源区域的相交部分。

如果 sourceWidth 或 sourceHeight 为零，则MoveBufferArea方法不执行任何操作。