Console.MoveBufferArea Método
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
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 -> unitstatic member MoveBufferArea : int * int * int * int * int * int -> unitPublic 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 -> unitstatic member MoveBufferArea : int * int * int * int * int * int * char * ConsoleColor * ConsoleColor -> unitPublic 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.