Console.MoveBufferArea Método

Definição

Namespace:

System

Assemblies:

netstandard.dll, System.Console.dll

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

Sobrecargas

Nome	Description
MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32, Char, ConsoleColor, ConsoleColor)	Copia uma área de origem especificada do buffer de tela para uma área de destino especificada.
MoveBufferArea(Int32, Int32, Int32, Int32, Int32, Int32)	Copia uma área de origem especificada do buffer de tela para uma área de destino especificada.

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

Origem:

Console.cs

Copia uma área de origem especificada do buffer de 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);

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

Parâmetros

sourceLeft

Int32

A coluna mais à esquerda da área de origem.

sourceTop

Int32

A linha mais alta 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 mais alta da área de destino.

sourceChar

Char

O caractere usado para preencher a área de origem.

sourceForeColor

ConsoleColor

A cor do 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 é menor 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 membros da ConsoleColor enumeração.

SecurityException

O usuário não tem permissão para executar esta 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 destino e de origem especificarem uma posição localizada além dos limites do buffer de tela atual, somente a parte da área de origem que se encaixa 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 cruza a área de origem, a área de origem será preenchida com o caractere especificado, sourceCharusando 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 executa nenhuma operação se sourceWidth ou sourceHeight é zero.

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

Origem:

Console.cs

Copia uma área de origem especificada do buffer de 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);

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

Parâmetros

sourceLeft

Int32

A coluna mais à esquerda da área de origem.

sourceTop

Int32

A linha mais alta 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 mais alta da área de destino.

Atributos

SupportedOSPlatformAttribute

Exceções

ArgumentOutOfRangeException

Um ou mais dos parâmetros é menor 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 esta 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 destino e origem especificarem uma posição localizada fora dos limites do buffer de tela atual, somente a parte da área de origem que se encaixa 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 cruzar a área de origem, a área de origem será preenchida com espaços em branco usando as cores de plano de fundo e de primeiro plano atuais. Caso contrário, a parte interseccionada da área de origem não será preenchida.