Console.WindowTop 속성
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
화면 버퍼에 상대적인 콘솔 창 영역의 위쪽 위치를 가져오거나 설정합니다.
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")>]
member this.WindowTop : int with get, setmember this.WindowTop : int with get, setPublic Shared Property WindowTop As Integer속성 값
맨 위 콘솔 창 위치(행)입니다.
- 특성
예외
정보를 읽거나 쓰는 동안 오류가 발생했습니다.
설정 작업은 Windows 이외의 운영 체제에서 호출됩니다.
예제
다음 예제에서는 , , WindowTop, WindowWidth, WindowHeight, BufferHeightBufferWidth및 속성과 CursorVisible , SetBufferSize및 ReadKey 메서드를 SetWindowPosition보여 WindowLeft줍니다. 이 예제에서는 화면 버퍼 너비에 따라 화면 버퍼에 그리드 패턴을 그립니다. 그런 다음 위쪽 화살표, 아래쪽 화살표, 왼쪽 화살표 또는 오른쪽 화살표 콘솔 키를 누른 위치에 대한 응답으로 콘솔 창을 이동하는 예제입니다. 그리드 패턴을 사용하면 화면 버퍼를 기준으로 콘솔 창의 움직임을 볼 수 있습니다.
// 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
설명
콘솔은 사각형 창을 더 큰 사각형 버퍼 영역으로 나타냅니다. 창과 버퍼는 모두 행 수와 열 수에 따라 세로로 측정됩니다. 버퍼 영역의 차원은 및 BufferWidth 속성에 BufferHeight 의해 정의됩니다. 콘솔 영역의 차원은 및 WindowWidth 속성에 WindowHeight 의해 정의됩니다. 이 속성은 WindowTop 콘솔 창의 첫 번째 열에 표시되는 버퍼 영역의 행을 결정합니다. 속성 값의 WindowTop 범위는 0 BufferHeight - WindowHeight에서 . 해당 범위를 ArgumentOutOfRangeException벗어난 값으로 설정하려고 하면 .
출력이 리디렉션될 때 속성 값을 WindowTop 설정하려고 하면 예외가 IOException throw됩니다. 예외를 방지하려면 속성이 반환false되는 경우에만 IsOutputRedirected 이 속성의 값을 설정할 수 있습니다.