Partilhar via


Console.MoveBufferArea Método

Definição

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

Exceções

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.

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

Ocorreu um erro de E/S.

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.

Aplica-se a

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

Exceções

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.

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

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

Ocorreu um erro de E/S.

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.

Aplica-se a