Console.WindowTop Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta la posizione più in alto della finestra della console relativamente al buffer dello schermo.
public:
static property int WindowTop { int get(); void set(int value); };public static int WindowTop { get; [System.Runtime.Versioning.SupportedOSPlatform("windows")] set; }public static int WindowTop { get; set; }[<set: System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member WindowTop : int with get, setstatic member WindowTop : int with get, setPublic Shared Property WindowTop As IntegerValore della proprietà
Posizione più in alto della finestra della console misurata in righe.
- Attributi
Eccezioni
In un'operazione set il valore da assegnare è minore di zero.
-oppure-
In seguito all'assegnazione, la somma di WindowTop e WindowHeight supererebbe BufferHeight.
Si è verificato un errore durante la lettura o la scrittura delle informazioni.
L'operazione set viene richiamata su un sistema operativo diverso da Windows.
Esempio
Nell'esempio seguente vengono illustrate le WindowLeftproprietà , WindowWidthWindowTop, WindowHeight, BufferWidth, BufferHeighte CursorVisible e i SetWindowPositionmetodi , SetBufferSizee ReadKey . L'esempio disegna un motivo griglia nel buffer dello schermo in base alla larghezza del buffer dello schermo. L'esempio sposta quindi la finestra della console in risposta a cui vengono premuti i tasti della console FRECCIA SU, FRECCIA GIÙ, FRECCIA SINISTRA o FRECCIA DESTRA. Il modello griglia consente di visualizzare lo spostamento della finestra della console rispetto al buffer dello schermo.
// This example demonstrates the Console.WindowLeft and
// Console.WindowTop properties.
using namespace System;
using namespace System::Text;
using namespace System::IO;
//
int saveBufferWidth;
int saveBufferHeight;
int saveWindowHeight;
int saveWindowWidth;
bool saveCursorVisible;
//
int main()
{
String^ m1 = "1) Press the cursor keys to move the console window.\n"
"2) Press any key to begin. When you're finished...\n"
"3) Press the Escape key to quit.";
String^ g1 = "+----";
String^ g2 = "| ";
String^ grid1;
String^ grid2;
StringBuilder^ sbG1 = gcnew StringBuilder;
StringBuilder^ sbG2 = gcnew StringBuilder;
ConsoleKeyInfo cki;
int y;
//
try
{
saveBufferWidth = Console::BufferWidth;
saveBufferHeight = Console::BufferHeight;
saveWindowHeight = Console::WindowHeight;
saveWindowWidth = Console::WindowWidth;
saveCursorVisible = Console::CursorVisible;
//
Console::Clear();
Console::WriteLine( m1 );
Console::ReadKey( true );
// Set the smallest possible window size before setting the buffer size.
Console::SetWindowSize( 1, 1 );
Console::SetBufferSize( 80, 80 );
Console::SetWindowSize( 40, 20 );
// Create grid lines to fit the buffer. (The buffer width is 80, but
// this same technique could be used with an arbitrary buffer width.)
for ( y = 0; y < Console::BufferWidth / g1->Length; y++ )
{
sbG1->Append( g1 );
sbG2->Append( g2 );
}
sbG1->Append( g1, 0, Console::BufferWidth % g1->Length );
sbG2->Append( g2, 0, Console::BufferWidth % g2->Length );
grid1 = sbG1->ToString();
grid2 = sbG2->ToString();
Console::CursorVisible = false;
Console::Clear();
for ( y = 0; y < Console::BufferHeight - 1; y++ )
{
if ( y % 3 == 0 )
Console::Write( grid1 );
else
Console::Write( grid2 );
}
Console::SetWindowPosition( 0, 0 );
do
{
cki = Console::ReadKey( true );
switch ( cki.Key )
{
case ConsoleKey::LeftArrow:
if ( Console::WindowLeft > 0 )
Console::SetWindowPosition( Console::WindowLeft - 1, Console::WindowTop );
break;
case ConsoleKey::UpArrow:
if ( Console::WindowTop > 0 )
Console::SetWindowPosition( Console::WindowLeft, Console::WindowTop - 1 );
break;
case ConsoleKey::RightArrow:
if ( Console::WindowLeft < (Console::BufferWidth - Console::WindowWidth) )
Console::SetWindowPosition( Console::WindowLeft + 1, Console::WindowTop );
break;
case ConsoleKey::DownArrow:
if ( Console::WindowTop < (Console::BufferHeight - Console::WindowHeight) )
Console::SetWindowPosition( Console::WindowLeft, Console::WindowTop + 1 );
break;
}
}
while ( cki.Key != ConsoleKey::Escape );
}
catch ( IOException^ e )
{
Console::WriteLine( e->Message );
}
finally
{
Console::Clear();
Console::SetWindowSize( 1, 1 );
Console::SetBufferSize( saveBufferWidth, saveBufferHeight );
Console::SetWindowSize( saveWindowWidth, saveWindowHeight );
Console::CursorVisible = saveCursorVisible;
}
} // end Main
/*
This example produces results similar to the following:
1) Press the cursor keys to move the console window.
2) Press any key to begin. When you're finished...
3) Press the Escape key to quit.
...
+----+----+----+-
| | | |
| | | |
+----+----+----+-
| | | |
| | | |
+----+----+----+-
*/
// This example demonstrates the Console.WindowLeft and
// Console.WindowTop properties.
using System;
using System.Text;
using System.IO;
//
class Sample
{
public static int saveBufferWidth;
public static int saveBufferHeight;
public static int saveWindowHeight;
public static int saveWindowWidth;
public static bool saveCursorVisible;
//
public static void Main()
{
string m1 = "1) Press the cursor keys to move the console window.\n" +
"2) Press any key to begin. When you're finished...\n" +
"3) Press the Escape key to quit.";
string g1 = "+----";
string g2 = "| ";
string grid1;
string grid2;
StringBuilder sbG1 = new StringBuilder();
StringBuilder sbG2 = new StringBuilder();
ConsoleKeyInfo cki;
int y;
//
try
{
saveBufferWidth = Console.BufferWidth;
saveBufferHeight = Console.BufferHeight;
saveWindowHeight = Console.WindowHeight;
saveWindowWidth = Console.WindowWidth;
saveCursorVisible = Console.CursorVisible;
//
Console.Clear();
Console.WriteLine(m1);
Console.ReadKey(true);
// Set the smallest possible window size before setting the buffer size.
Console.SetWindowSize(1, 1);
Console.SetBufferSize(80, 80);
Console.SetWindowSize(40, 20);
// Create grid lines to fit the buffer. (The buffer width is 80, but
// this same technique could be used with an arbitrary buffer width.)
for (y = 0; y < Console.BufferWidth/g1.Length; y++)
{
sbG1.Append(g1);
sbG2.Append(g2);
}
sbG1.Append(g1, 0, Console.BufferWidth%g1.Length);
sbG2.Append(g2, 0, Console.BufferWidth%g2.Length);
grid1 = sbG1.ToString();
grid2 = sbG2.ToString();
Console.CursorVisible = false;
Console.Clear();
for (y = 0; y < Console.BufferHeight-1; y++)
{
if (y%3 == 0)
Console.Write(grid1);
else
Console.Write(grid2);
}
Console.SetWindowPosition(0, 0);
do
{
cki = Console.ReadKey(true);
switch (cki.Key)
{
case ConsoleKey.LeftArrow:
if (Console.WindowLeft > 0)
Console.SetWindowPosition(
Console.WindowLeft-1, Console.WindowTop);
break;
case ConsoleKey.UpArrow:
if (Console.WindowTop > 0)
Console.SetWindowPosition(
Console.WindowLeft, Console.WindowTop-1);
break;
case ConsoleKey.RightArrow:
if (Console.WindowLeft < (Console.BufferWidth-Console.WindowWidth))
Console.SetWindowPosition(
Console.WindowLeft+1, Console.WindowTop);
break;
case ConsoleKey.DownArrow:
if (Console.WindowTop < (Console.BufferHeight-Console.WindowHeight))
Console.SetWindowPosition(
Console.WindowLeft, Console.WindowTop+1);
break;
}
}
while (cki.Key != ConsoleKey.Escape); // end do-while
} // end try
catch (IOException e)
{
Console.WriteLine(e.Message);
}
finally
{
Console.Clear();
Console.SetWindowSize(1, 1);
Console.SetBufferSize(saveBufferWidth, saveBufferHeight);
Console.SetWindowSize(saveWindowWidth, saveWindowHeight);
Console.CursorVisible = saveCursorVisible;
}
} // end Main
} // end Sample
/*
This example produces results similar to the following:
1) Press the cursor keys to move the console window.
2) Press any key to begin. When you're finished...
3) Press the Escape key to quit.
...
+----+----+----+-
| | | |
| | | |
+----+----+----+-
| | | |
| | | |
+----+----+----+-
*/
' This example demonstrates the Console.WindowLeft and
' Console.WindowTop properties.
Imports System.IO
Imports System.Text
Class Sample
Public Shared saveBufferWidth As Integer
Public Shared saveBufferHeight As Integer
Public Shared saveWindowHeight As Integer
Public Shared saveWindowWidth As Integer
Public Shared saveCursorVisible As Boolean
Public Shared Sub Main()
Dim m1 As String = _
"1) Press the cursor keys to move the console window." & vbCrlf & _
"2) Press any key to begin. When you're finished..." & vbCrlf & _
"3) Press the Escape key to quit."
Dim g1 As String = "+----"
Dim g2 As String = "| "
Dim grid1 As String
Dim grid2 As String
Dim sbG1 As New StringBuilder()
Dim sbG2 As New StringBuilder()
Dim cki As ConsoleKeyInfo
Dim y As Integer
'
Try
saveBufferWidth = Console.BufferWidth
saveBufferHeight = Console.BufferHeight
saveWindowHeight = Console.WindowHeight
saveWindowWidth = Console.WindowWidth
saveCursorVisible = Console.CursorVisible
'
Console.Clear()
Console.WriteLine(m1)
Console.ReadKey(True)
' Set the smallest possible window size before setting the buffer size.
Console.SetWindowSize(1, 1)
Console.SetBufferSize(80, 80)
Console.SetWindowSize(40, 20)
' Create grid lines to fit the buffer. (The buffer width is 80, but
' this same technique could be used with an arbitrary buffer width.)
For y = 0 To (Console.BufferWidth / g1.Length) - 1
sbG1.Append(g1)
sbG2.Append(g2)
Next y
sbG1.Append(g1, 0, Console.BufferWidth Mod g1.Length)
sbG2.Append(g2, 0, Console.BufferWidth Mod g2.Length)
grid1 = sbG1.ToString()
grid2 = sbG2.ToString()
Console.CursorVisible = False
Console.Clear()
For y = 0 To (Console.BufferHeight - 2)
If y Mod 3 = 0 Then
Console.Write(grid1)
Else
Console.Write(grid2)
End If
Next y
'
Console.SetWindowPosition(0, 0)
Do
cki = Console.ReadKey(True)
Select Case cki.Key
Case ConsoleKey.LeftArrow
If Console.WindowLeft > 0 Then
Console.SetWindowPosition(Console.WindowLeft - 1, Console.WindowTop)
End If
Case ConsoleKey.UpArrow
If Console.WindowTop > 0 Then
Console.SetWindowPosition(Console.WindowLeft, Console.WindowTop - 1)
End If
Case ConsoleKey.RightArrow
If Console.WindowLeft < Console.BufferWidth - Console.WindowWidth Then
Console.SetWindowPosition(Console.WindowLeft + 1, Console.WindowTop)
End If
Case ConsoleKey.DownArrow
If Console.WindowTop < Console.BufferHeight - Console.WindowHeight Then
Console.SetWindowPosition(Console.WindowLeft, Console.WindowTop + 1)
End If
End Select
Loop While cki.Key <> ConsoleKey.Escape
' end do-while
' end try
Catch e As IOException
Console.WriteLine(e.Message)
Finally
Console.Clear()
Console.SetWindowSize(1, 1)
Console.SetBufferSize(saveBufferWidth, saveBufferHeight)
Console.SetWindowSize(saveWindowWidth, saveWindowHeight)
Console.CursorVisible = saveCursorVisible
End Try
End Sub
End Class
'
'This example produces results similar to the following:
'
'1) Press the cursor keys to move the console window.
'2) Press any key to begin. When you're finished...
'3) Press the Escape key to quit.
'
'...
'
'+----+----+----+-
'| | | |
'| | | |
'+----+----+----+-
'| | | |
'| | | |
'+----+----+----+-
'
// This example demonstrates the Console.WindowLeft and
// Console.WindowTop properties.
open System
open System.Text
open System.IO
[<EntryPoint>]
let main argv =
let m1 =
"1) Press the cursor keys to move the console window.\n" +
"2) Press any key to begin. When you're finished...\n" +
"3) Press the Escape key to quit."
let g1 = "+----";
let g2 = "| ";
let sbG1 = StringBuilder()
let sbG2 = StringBuilder()
let saveBufferWidth = Console.BufferWidth
let saveBufferHeight = Console.BufferHeight
let saveWindowHeight = Console.WindowHeight
let saveWindowWidth = Console.WindowWidth
let saveCursorVisible = Console.CursorVisible
try
try
Console.Clear()
Console.WriteLine(m1)
Console.ReadKey(true) |> ignore
// Set the smallest possible window size before setting the buffer size.
Console.SetWindowSize(1, 1)
Console.SetBufferSize(80, 80)
Console.SetWindowSize(40, 20)
// Create grid lines to fit the buffer. (The buffer width is 80, but
// this same technique could be used with an arbitrary buffer width.)
// for y = 0 to (Console.BufferWidth / g1.Length - 1)
for _ in 1..(Console.BufferWidth / g1.Length) do
(sbG1.Append(g1)) |> ignore
(sbG2.Append(g2)) |> ignore
sbG1.Append(g1, 0, Console.BufferWidth % g1.Length) |> ignore
sbG2.Append(g2, 0, Console.BufferWidth % g2.Length) |> ignore
let grid1 = sbG1.ToString()
let grid2 = sbG2.ToString()
Console.CursorVisible <- false
Console.Clear()
for y in 0..(Console.BufferHeight - 1) do
if (y % 3 = 0) then
Console.Write(grid1)
else
Console.Write(grid2)
Console.SetWindowPosition(0, 0)
let interactiveKeySequence =
Seq.initInfinite (fun _ -> (Console.ReadKey(true)).Key)
|> Seq.takeWhile (fun key -> key <> ConsoleKey.Escape)
for key in interactiveKeySequence do
match key with
| ConsoleKey.LeftArrow ->
if Console.WindowLeft > 0
then Console.SetWindowPosition(Console.WindowLeft - 1, Console.WindowTop)
| ConsoleKey.UpArrow ->
if Console.WindowTop > 0
then Console.SetWindowPosition(Console.WindowLeft, Console.WindowTop - 1)
| ConsoleKey.RightArrow ->
if Console.WindowLeft < (Console.BufferWidth - Console.WindowWidth)
then Console.SetWindowPosition(Console.WindowLeft + 1, Console.WindowTop)
| ConsoleKey.DownArrow ->
if Console.WindowTop < (Console.BufferHeight - Console.WindowHeight)
then Console.SetWindowPosition(Console.WindowLeft, Console.WindowTop + 1)
| _ ->
()
0
with
| :? IOException as ex -> printf "%s" ex.Message; 1
finally
Console.Clear()
Console.SetWindowSize(1, 1)
Console.SetBufferSize(saveBufferWidth, saveBufferHeight)
Console.SetWindowSize(saveWindowWidth, saveWindowHeight)
Console.CursorVisible <- saveCursorVisible
Commenti
La console rappresenta una finestra rettangolare in un'area buffer rettangolare più grande. Sia la finestra che il buffer vengono misurati verticalmente in base al numero di righe e orizzontalmente in base al numero di colonne. Le dimensioni dell'area del buffer sono definite dalle BufferHeight proprietà e BufferWidth . Le dimensioni dell'area della console sono definite dalle WindowHeight proprietà e WindowWidth . La WindowTop proprietà determina quale riga dell'area del buffer viene visualizzata nella prima colonna della finestra della console. Il valore della WindowTop proprietà può variare da 0 a - BufferHeightWindowHeight . Il tentativo di impostarlo su un valore esterno a tale intervallo genera un'eccezione ArgumentOutOfRangeException.
Il tentativo di impostare il valore della proprietà quando l'output WindowTop viene reindirizzato genera un'eccezione IOException . Per evitare l'eccezione, è possibile impostare il valore di questa proprietà solo se la IsOutputRedirected proprietà restituisce false.
Si applica a
Collabora con noi su GitHub
L'origine di questo contenuto è disponibile in GitHub, in cui è anche possibile creare ed esaminare i problemi e le richieste pull. Per ulteriori informazioni, vedere la guida per i collaboratori.
