Console.SetWindowPosition(Int32, Int32) Methode
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Legt die Position des Konsolenfensters relativ zum Bildschirmpuffer fest.
public:
static void SetWindowPosition(int left, int top);
[System.Runtime.Versioning.SupportedOSPlatform("windows")]
public static void SetWindowPosition (int left, int top);
public static void SetWindowPosition (int left, int top);
[<System.Runtime.Versioning.SupportedOSPlatform("windows")>]
static member SetWindowPosition : int * int -> unit
static member SetWindowPosition : int * int -> unit
Public Shared Sub SetWindowPosition (left As Integer, top As Integer)
Parameter
- left
- Int32
Die Spaltenposition der linken oberen Ecke des Konsolenfensters.
- top
- Int32
Die Zeilenposition der linken oberen Ecke des Konsolenfensters.
- Attribute
Ausnahmen
left oder top ist kleiner als 0.
- oder -
left + WindowWidth ist größer als BufferWidth.
- oder -
top + WindowHeight ist größer als BufferHeight.
Der Benutzer verfügt nicht über die erforderlichen Berechtigung, um diese Aktion durchzuführen.
E/A-Fehler
Das aktuelle Betriebssystem ist nicht Windows.
Beispiele
Im folgenden Beispiel werden die WindowLeft Eigenschaften , , , , , und sowie die WindowTop Methoden , und WindowWidth WindowHeight BufferWidth BufferHeight CursorVisible SetWindowPosition SetBufferSize ReadKey veranschaulicht. Das Beispiel zeichnet ein Rastermuster im Bildschirmpuffer basierend auf der Breite des Bildschirmpuffers. Anschließend verschiebt das Beispiel das Konsolenfenster als Reaktion darauf, auf welche der Konsolentasten NACH-OBEN, NACH-UNTEN, NACH-LINKS oder NACH-RECHTS-TASTE gedrückt wird. Das Rastermuster hilft Ihnen, die Verschiebung des Konsolenfensters relativ zum Bildschirmpuffer anzuzeigen.
// 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
'