Partilhar via


Console.WindowLeft Propriedade

Definição

Obtém ou define a posição mais à esquerda da área da janela do console em relação ao buffer da tela.

public:
 static property int WindowLeft { int get(); void set(int value); };
public static int WindowLeft { get; [System.Runtime.Versioning.SupportedOSPlatform("windows")] set; }
public static int WindowLeft { get; set; }
[<set: System.Runtime.Versioning.SupportedOSPlatform("windows")>]
member this.WindowLeft : int with get, set
member this.WindowLeft : int with get, set
Public Shared Property WindowLeft As Integer

Valor da propriedade

Int32

A posição da janela de console mais à esquerda medida em colunas.

Atributos

Exceções

Em uma operação de conjuntos, o valor a ser atribuído é menor que zero.

  • ou -

Como resultado da atribuição, a soma de WindowLeft e WindowWidth excederá BufferWidth.

Erro na leitura ou na gravação das informações.

A operação set é invocada em um sistema operacional diferente do Windows.

Exemplos

O exemplo a seguir abre uma janela do console de 80 colunas e define uma área de buffer com 120 colunas de largura. Ele exibe informações sobre o tamanho da janela e do buffer e aguarda até que o usuário pressione a tecla SETA PARA A ESQUERDA ou a tecla SETA PARA A DIREITA. No primeiro caso, ele diminui o valor da propriedade em um se WindowLeft o resultado for um valor legal. No último caso, ele aumentará o valor da propriedade em um se WindowLeft o resultado for legal. Observe que o exemplo não precisa lidar com um , pois verifica se o valor a ser atribuído à propriedade não é negativo e não faz com que a soma das propriedades e exceda o valor da ArgumentOutOfRangeException WindowLeft propriedade WindowLeft WindowWidth BufferWidth .

using namespace System;

void ShowConsoleStatistics()
{
   Console::WriteLine("Console statistics:");
   Console::WriteLine("   Buffer: {0} x {1}", Console::BufferHeight, Console::BufferWidth);
   Console::WriteLine("   Window: {0} x {1}", Console::WindowHeight, Console::WindowWidth);
   Console::WriteLine("   Window starts at {0}.", Console::WindowLeft);
   Console::WriteLine("Press <- or -> to move window, Ctrl+C to exit.");
}

int main()
{
   ConsoleKeyInfo key;
   bool moved = false;

   Console::BufferWidth = 120;
   Console::Clear();

   ShowConsoleStatistics();
   
   do {
      key = Console::ReadKey(true);
      if (key.Key == ConsoleKey::LeftArrow)
      {
         int pos = Console::WindowLeft - 1;
         if (pos >= 0 && pos + Console::WindowWidth <= Console::BufferWidth)
         { 
            Console::WindowLeft = pos;
            moved = true;
         }       
      } 
      else if (key.Key == ConsoleKey::RightArrow)
      {
            int pos = Console::WindowLeft + 1;
            if (pos + Console::WindowWidth <= Console::BufferWidth)
            { 
               Console::WindowLeft = pos;
               moved = true;
            }
      }
      if (moved)
      { 
         ShowConsoleStatistics(); 
         moved = false;
      }   
      Console::WriteLine();
   } while (true);
}
using System;

public class Example
{
   public static void Main()
   {
      ConsoleKeyInfo key;
      bool moved = false;

      Console.BufferWidth += 4;
      Console.Clear();

      ShowConsoleStatistics();
      do
      {
         key = Console.ReadKey(true);
         if (key.Key == ConsoleKey.LeftArrow)
         {
            int pos = Console.WindowLeft - 1;
            if (pos >= 0 && pos + Console.WindowWidth <= Console.BufferWidth)
            {
               Console.WindowLeft = pos;
               moved = true;
            }
         }
         else if (key.Key == ConsoleKey.RightArrow)
         {
            int pos = Console.WindowLeft + 1;
            if (pos + Console.WindowWidth <= Console.BufferWidth)
            {
               Console.WindowLeft = pos;
               moved = true;
            }
         }
         if (moved)
         {
            ShowConsoleStatistics();
            moved = false;
         }
         Console.WriteLine();
      } while (true);
   }

   private static void ShowConsoleStatistics()
   {
      Console.WriteLine("Console statistics:");
      Console.WriteLine("   Buffer: {0} x {1}", Console.BufferHeight, Console.BufferWidth);
      Console.WriteLine("   Window: {0} x {1}", Console.WindowHeight, Console.WindowWidth);
      Console.WriteLine("   Window starts at {0}.", Console.WindowLeft);
      Console.WriteLine("Press <- or -> to move window, Ctrl+C to exit.");
   }
}
open System

let showConsoleStatistics () =
    printfn "Console statistics:"
    printfn $"   Buffer: {Console.BufferHeight} x {Console.BufferWidth}" 
    printfn $"   Window: {Console.WindowHeight} x {Console.WindowWidth}"
    printfn $"   Window starts at {Console.WindowLeft}."
    printfn "Press <- or -> to move window, Ctrl+C to exit."

Console.BufferWidth <- Console.BufferWidth + 4
Console.Clear()

showConsoleStatistics ()

let mutable moved = false

while true do
    let key = Console.ReadKey true
    if key.Key = ConsoleKey.LeftArrow then
        let pos = Console.WindowLeft - 1
        if pos >= 0 && pos + Console.WindowWidth <= Console.BufferWidth then
            Console.WindowLeft <- pos
            moved <- true
    elif key.Key = ConsoleKey.RightArrow then
        let pos = Console.WindowLeft + 1
        if pos + Console.WindowWidth <= Console.BufferWidth then
            Console.WindowLeft <- pos
            moved <- true
    if moved then
        showConsoleStatistics ()
        moved <- false
    
    printfn ""
Module Example
   Public Sub Main()
      Dim key As ConsoleKeyInfo
      Dim moved As Boolean = False
            
      Console.BufferWidth = 120
      Console.Clear()
      
      ShowConsoleStatistics()
      Do While True
         key = Console.ReadKey(True)
         If key.Key = ConsoleKey.LeftArrow Then
            Dim pos As Integer = Console.WindowLeft - 1
            If pos >= 0 And pos + Console.WindowWidth <= Console.BufferWidth Then 
               Console.WindowLeft = pos
               moved = True
            End If       
         ElseIf key.Key = ConsoleKey.RightArrow Then
            Dim pos As Integer = Console.WindowLeft + 1
            If pos + Console.WindowWidth <= Console.BufferWidth Then 
               Console.WindowLeft = pos
               moved = True
            End If
         End If
         If moved Then ShowConsoleStatistics() : moved = False
         Console.WriteLine()
      Loop
   End Sub
   
   Private Sub ShowConsoleStatistics()
      Console.WriteLine("Console statistics:")
      Console.WriteLine("   Buffer: {0} x {1}", Console.BufferHeight, Console.BufferWidth)
      Console.WriteLine("   Window: {0} x {1}", Console.WindowHeight, Console.WindowWidth)
      Console.WriteLine("   Window starts at {0}.", Console.WindowLeft)
      Console.WriteLine("Press <- or -> to move window, Ctrl+C to exit.")
   End Sub
End Module

Comentários

O console representa uma janela retangular em uma área de buffer retangular maior. Tanto a janela quanto o buffer são medidos verticalmente por seu número de linhas e horizontalmente pelo número de colunas. As dimensões da área de buffer são definidas pelas BufferHeight Propriedades e BufferWidth . As dimensões da área do console são definidas pelas WindowHeight Propriedades e WindowWidth . A WindowLeft propriedade determina qual coluna da área de buffer é exibida na primeira coluna da janela do console. O valor da WindowLeft propriedade pode variar de 0 a BufferWidth - WindowWidth . A tentativa de defini-lo como um valor fora desse intervalo gera um ArgumentOutOfRangeException .

Quando uma janela de console é aberta pela primeira vez, o valor padrão da WindowLeft propriedade é zero, o que indica que a primeira coluna mostrada pelo console corresponde à primeira coluna (a coluna na posição zero) na área de buffer. A largura padrão da janela do console e da área de buffer é de 80 colunas. Isso significa que a WindowLeft propriedade só poderá ser modificada se a janela do console for mais estreita ou se a área do buffer for mais larga.

Observe que, se a largura da área do buffer exceder a largura da janela do console, o valor da WindowLeft propriedade será ajustado automaticamente quando o usuário usar a barra de rolagem horizontal para definir a relação da janela com a área de buffer.

A tentativa de definir o valor da WindowLeft propriedade quando a saída é redirecionada gera uma IOException exceção. Para evitar a exceção, você poderá definir o valor dessa propriedade somente se a IsOutputRedirected propriedade retornar false .

Aplica-se a