Console.MoveBufferArea Método

Definição

Namespace:

System

Assembly:

System.Console.dll

Assembly:

netstandard.dll

Assembly:

mscorlib.dll

Copia uma área de fonte especificada do buffer da tela para uma área de destino especificada.

Sobrecargas

MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32)	Copia uma área de fonte especificada do buffer da tela para uma área de destino especificada.
MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor)	Copia uma área de fonte especificada do buffer da tela para uma área de destino especificada.

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

Copia uma área de fonte especificada do buffer da tela para uma área de destino especificada.

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)

Parâmetros

sourceLeft

Int32

A coluna mais à esquerda da área de origem.

sourceTop

Int32

A linha superior da área de origem.

sourceWidth

Int32

O número de colunas na área de origem.

sourceHeight

Int32

O número de linhas na área de origem.

targetLeft

Int32

A coluna mais à esquerda da área de destino.

targetTop

Int32

A linha superior da área de destino.

Atributos

SupportedOSPlatformAttribute

Exceções

ArgumentOutOfRangeException

Um ou mais dos parâmetros são menores que zero.

• ou -

sourceLeft ou targetLeft é maior ou igual a BufferWidth.

• ou -

sourceTop ou targetTop é maior ou igual a BufferHeight.

• ou -

sourceTop + sourceHeight é maior ou igual a BufferHeight.

• ou -

sourceLeft + sourceWidth é maior ou igual a BufferWidth.

SecurityException

O usuário não tem permissão para executar essa ação.

IOException

Ocorreu um erro de E/S.

PlatformNotSupportedException

O sistema operacional atual não é o Windows.

Comentários

Se os parâmetros de origem e destino especificarem uma posição localizada fora dos limites do buffer de tela atual, somente a parte da área de origem que couber na área de destino será copiada. Ou seja, a área de origem é recortada para se ajustar ao buffer de tela atual.

O MoveBufferArea método copia a área de origem para a área de destino. Se a área de destino não interceptar a área de origem, a área de origem será preenchida com espaços em branco usando as cores de primeiro plano e plano de fundo atuais. Caso contrário, a parte interseccionada da área de origem não será preenchida.

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

Copia uma área de fonte especificada do buffer da tela para uma área de destino especificada.

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)

Parâmetros

sourceLeft

Int32

A coluna mais à esquerda da área de origem.

sourceTop

Int32

A linha superior da área de origem.

sourceWidth

Int32

O número de colunas na área de origem.

sourceHeight

Int32

O número de linhas na área de origem.

targetLeft

Int32

A coluna mais à esquerda da área de destino.

targetTop

Int32

A linha superior da área de destino.

sourceChar

Char

O caractere usado para preencher a área de origem.

sourceForeColor

ConsoleColor

A cor de primeiro plano usada para preencher a área de origem.

sourceBackColor

ConsoleColor

A cor da tela de fundo usada para preencher a área de origem.

Atributos

SupportedOSPlatformAttribute

Exceções

ArgumentOutOfRangeException

Um ou mais dos parâmetros são menores que zero.

• ou -

sourceLeft ou targetLeft é maior ou igual a BufferWidth.

• ou -

sourceTop ou targetTop é maior ou igual a BufferHeight.

• ou -

sourceTop + sourceHeight é maior ou igual a BufferHeight.

• ou -

sourceLeft + sourceWidth é maior ou igual a BufferWidth.

ArgumentException

Um ou ambos os parâmetros de cor não são membro da enumeração ConsoleColor.

SecurityException

O usuário não tem permissão para executar essa ação.

IOException

Ocorreu um erro de E/S.

PlatformNotSupportedException

O sistema operacional atual não é o Windows.

Comentários

Se os parâmetros de origem e destino especificarem uma posição localizada além dos limites do buffer de tela atual, somente a parte da área de origem que se ajusta na área de destino será copiada. Ou seja, a área de origem é recortada para se ajustar ao buffer de tela atual.

O MoveBufferArea método copia a área de origem para a área de destino. Se a área de destino não interceptar a área de origem, a área de origem será preenchida com o caractere especificado por sourceChar , usando as cores especificadas por sourceForeColor e sourceBackColor . Caso contrário, a parte interseccionada da área de origem não será preenchida.

O MoveBufferArea método não executará nenhuma operação se sourceWidth ou sourceHeight for zero.