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
  • 一个或多个参数小于零。
  • sourceLeft 或 targetLeft 大于等于 BufferWidth。
  • sourceTop 或 targetTop 大于等于 BufferHeight。
  • sourceTop + sourceHeight 大于等于 BufferHeight。
  • sourceLeft + sourceWidth 大于等于 BufferWidth。
ArgumentException 一个颜色参数不是或两个颜色参数都不是 System.ConsoleColor 枚举的成员。
SecurityException 该用户没有执行此操作的权限。
IOException 发生了 I/O 错误。

命名空间

namespace: System

程序集: mscorlib(在 mscorlib.dll 中)

版本信息

.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 系统要求。