Currently, PassFailJFrame positions the instructions independently of test UI window. In majority of cases, it gives good results: the frame with the instructions is positioned to the left of the screen centre and so that the frame is centred horizontally in the working area of the main monitor.

The first test window is position to the right of the screen centre, its top is aligned to the top of the instruction frame. Yet if the test window is significantly taller than the instructions, it could be positioned too low on the screen, sometimes it may even be outside of working area.

The initial implementation, JDK-8283712, positioned both the instructions and the test window in the same method, positionTestWindow, however, it didn't take into account the height of both windows, only the instruction window. Now, after JDK-8294156, these two windows are positioned in different methods.

However, with the introduction of the Builder pattern in JDK-8294535, both the instruction frame and the test window are available. If the test window is significantly taller, it makes sense to centre the test window vertically on the screen and then align the top of the instruction frame with the test window. Alternatively, the height of both windows could always be taken into account.


The above description implies the default horizontal layout which is used in the vast majority of tests. Yet the issue is also applicable to vertical layout where the instructions are above the test window.

A custom layout implementing the PositionWindows interface can reposition the instruction frame, yet it shouldn't be necessary.