System.Console.MoveBufferArea 方法 (Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor)
方法描述
将屏幕缓冲区的指定源区域复制到指定的目标区域。
语法定义(C# System.Console.MoveBufferArea 方法 (Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor) 的用法)
public static void MoveBufferArea( int sourceLeft, int sourceTop, int sourceWidth, int sourceHeight, int targetLeft, int targetTop, char sourceChar, ConsoleColor sourceForeColor, ConsoleColor sourceBackColor )
参数/返回值
参数值/返回值 | 参数类型/返回类型 | 参数描述/返回描述 |
---|---|---|
sourceLeft | System-Int32 | 源区域最左边的列。 |
sourceTop | System-Int32 | 源区域最顶部的行。 |
sourceWidth | System-Int32 | 源区域中列的数目。 |
sourceHeight | System-Int32 | 源区域中的行的数目。 |
targetLeft | System-Int32 | 目标区域最左边的列。 |
targetTop | System-Int32 | 目标区域最顶部的行。 |
sourceChar | System-Char | 用于填充源区域的字符。 |
sourceForeColor | System-ConsoleColor | 用于填充源区域的前景色。 |
sourceBackColor | System-ConsoleColor | 用于填充源区域的背景色。 |
返回值 | void |
提示和注释
如果目标参数和源参数指定的位置位于当前屏幕缓冲区的边界之外,则仅复制源区域内适合目标区域的部分。 也就是说,会对源区域进行剪裁以适合当前屏幕缓冲区。
MoveBufferArea 方法将源区域复制到目标区域。 如果目标区域与源区域不相交,则使用 sourceForeColor 和 sourceBackColor 指定的颜色以及 sourceChar 指定的字符填充源区域。 如果目标区域与源区域相交,则不填充源区域中与目标区域相交的部分。
如果 sourceWidth 或 sourceHeight 为零,则 MoveBufferArea 方法不执行任何操作。
System.Console.MoveBufferArea 方法 (Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor)例子
异常
异常 | 异常描述 |
---|---|
ArgumentOutOfRangeException |
|
ArgumentException | 一个颜色参数不是或两个颜色参数都不是 System.ConsoleColor 枚举的成员。 |
SecurityException | 该用户没有执行此操作的权限。 |
IOException | 发生了 I/O 错误。 |
版本信息
.NET Framework 受以下版本支持:4、3.5、3.0、2.0 .NET Framework Client Profile 受以下版本支持:4、3.5 SP1
适用平台
Windows 7, Windows Vista SP1 或更高版本, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008(不支持服务器核心), Windows Server 2008 R2(支持 SP1 或更高版本的服务器核心), Windows Server 2003 SP2 .NET Framework 并不是对每个平台的所有版本都提供支持。有关支持的版本的列表,请参见.NET Framework 系统要求。