15.36 Benutzerinteraktionen automatisieren
Eine besondere Eigenschaft von Präsentationsprogrammen ist, dass Benutzerinteraktionen wie von Zauberhand automatisch vom System vorgenommen werden. Ein Programm kann beispielsweise die Interaktion mit der Maus oder der Tastatur aufnehmen und zu einem späteren Zeitpunkt abspielen. Genau für diese Art der Oberflächensteuerung gibt es die Klasse Robot im Paket AWT. Sie verwaltet eine mit Aktionen gefüllte Ereigniswarteschlange, die nacheinander abgearbeitet werden.
|
void keyPress( int keycode )
Drückt eine Taste. |
|
|
void keyRelease( int keycode )
Lässt die Tasten wieder frei. |
|
|
void mouseMove( int x, int y )
Bewegt die Maus auf die Koordinate relativ zum aktuellen Fenster. |
|
|
void mousePress( int buttons )
Aktiviert eine oder mehrere Maustasten. |
|
|
void mouseRelease( int buttons )
Lässt die Maustaste wieder los. |
|
|
void delay( int ms )
Wartet Millisekunden. Mehr als 60 Sekunden sind nicht möglich und das Resultat ist eine IllegalArgumentException. |
Bevor wir ein kleines Aufnahmeprogramm für Mausbewegungen schreiben, wenden wir uns den beiden interessanten Methoden keyPress(), keyRelease(), mousePress() beziehungsweise mouseRelease() zu, da die Parameter erklärungsbedürftig sind. Der Parameter keycode ist der erste, der beachtet werden muss.
Beispiel Der Roboter legt Tasten in die Ereignisschlange.
Robot rob = new Robot();
rob.keyPress( KeyEvent.VK_SHIFT );
rob.keyPress( KeyEvent.VK_U );
rob.keyPress( 'L' ); rob.keyPress( 'L' ); rob.keyPress( 'I' );
rob.keyPress( '0' ); rob.keyPress( '0' ); rob.keyPress( '7' );
rob.keyRelease( KeyEvent.VK_SHIFT );
rob.keyPress( KeyEvent.VK_ENTER );
|
Der Parameter von keyPress() und keyRelease() ist eine Konstante der Klasse KeyEvent. Neben den alphanumerischen Tasten auf der Tastatur finden sich unter anderem Konstanten für Funktionstasten, Metatasten, Cursortasten und weitere Sonderzeichen. Die Konstanten für Großbuchstaben und Ziffern decken sich mit den ASCII-Zeichen und können daher alternativ verwendet werden. Bei fast allen Sonderzeichen entspricht die Konstante dem ASCII-Code, jedoch ist dies nicht selbstverständlich. Die Kleinbuchstaben (ab 0x61) werden zum Beispiel auf den 10er-Block abgebildet (ab 0x60). Ist der übergebene Keycode undefiniert (durch die Konstante KeyEvent.VK_UNDEFINED vorgegeben), so erzeugt der Roboter eine IllegalArgumentException.
Um die Umschalttaste während der Automatisierung einzuschalten, nutzen wir keyPress(KeyEvent.VK_SHIFT) und lösen die Tasten mit keyRelease(). Das Beispiel macht deutlich, dass das Freigeben nur für Operationen wie zum Beispiel Shift, VK_ALT und VK_ALT_GRAPH nötig ist, allerdings nicht für normale Buchstaben.
Wird der obere Programmtext in einer grafischen Applikation genutzt, so muss sichergestellt sein, dass die Tasten auch die passende Komponente erwischen. Liegt der Fokus zum Beispiel auf einem Schieberegler, werden die Tastendrücke natürlich ohne Wirkung bleiben. Aus diesem Grund ist es angebracht, den Fokus zu setzen. Die Methode dazu war requestFocus(). Sie ist auf Component definiert.
Jetzt fehlen uns noch die Methoden mousePress() und mouseRelease(). Beide erhalten als Parameter eine Konstante der Klasse InputEvent; entweder BUTTON1_MASK, BUTTON2_MASK oder BUTTON3_MASK oder eine Kombination aus den dreien wie BUTTON2_MASK | BUTTON3_MASK.
|
Beispiel Folgende Zeilen aktiviert die (meist linke) Maustaste, wartet eine Sekunde und lässt dann die Maustaste wieder los.
rob.mousePress( InputEvent.BUTTON1_MASK );
rob.delay( 1000 );
rob.mouseRelease( InputEvent.BUTTON1_MASK );
|
Wenn die Mausaktion eine Komponente treffen soll, dann gilt das Gleiche wie für Tastendrücke. Nur muss hier der Fokus nicht auf der Komponente liegen, sondern die Mauskoordinaten müssen auf die Komponente zeigen. Damit die Bildschirmkoordinate einer Komponente ausgelesen werden kann, bietet Component eine Methode getLocation OnScreen() an, die ein Point-Objekt mit den Startkoordinaten liefert. Diese können mit einem kleinen Offset an mouseMove() weitergereicht werden. Dann befindet sich der Zeiger über der Komponente und mousePress() kann seine Wirkung nicht mehr verfehlen.
Methoden zur Zeitsteuerung
|
|
void setAutoDelay( int ms )
Die Robot-Klasse sendet zum Abspielen Ereignisse an die Oberfläche. Diese Methode setzt die Dauer der Verzögerung fest, die nach dem Ereignis vergehen soll. Mehr als 60 Sekunden sind auch hier nicht gültig. |
|
|
int getAutoDelay()
Liefert die Zeit, die nach dem Ereignisaufruf vergehen soll. |
|
|
void waitForIdle()
Wartet, bis alle Ereignisse in der Warteschlange bearbeitet sind. |
|
|
void setAutoWaitForIdle( boolean isOn )
Setzt, ob waitForIdle() nach einem Ereignis aufgerufen wird. |
|
|
boolean isAutoWaitForIdle()
Liefert true, falls der Robot automatisch waitForIdle() nach einem Ereignis aufruft. |
Funktionsweise und Beschränkungen
Für die Steuerung auf der Rechnerseite sind insbesondere unter Unix-Systemen beim netzwerkfähigen X-Window System (X11) einige Anforderungen zu erfüllen. Hier sind Rechte erforderlich, um auf der unteren Ebene Ereignisse platzieren zu können. Ein X-Window System benötigt hierfür die aktivierte Standarderweiterung XTEST 2.2. Verletzt die aktuelle Architektur diese Vorgaben, so wird während der Konstruktion eines Robot-Objekts eine AWTException ausgelöst.
|
