Java Screen Full Size initializeScreenArea(int priority)

Description

If you use methods such as #ensureOnScreen(java.awt.Rectangle) , #getContainingScreenBounds(java.awt.Rectangle,boolean) or #getScreenArea() for the first time, it will take up to a couple of seconds to run because it needs to get device information.

License

Open Source License

Parameter

Parameter	Description
priority	as we will use a thread to calculate the screen area, you can use this parameter to control the priority of the thread. If you are waiting for the result before the next step, you should use normal priority (which is 5). If you just want to calculate when app starts, you can use a lower priority (such as 3). For example, AbstractComboBox needs screen size so that the popup doesn't go beyond the screen. So when AbstractComboBox is used, we will kick off the thread at priority 3. If user clicks on the drop down after the thread finished, there will be no time delay.

Declaration

@Deprecated
synchronized public static void initializeScreenArea(int priority)

Method Source Code


//package com.java2s;

import java.awt.*;

public class Main {
    /** @deprecated No longer used. */
    @Deprecated/*from  ww  w .j a v a  2  s  .  c  om*/
    public static boolean INITIALIZE_SCREEN_AREA_USING_THREAD = true;

    /**
     * If you use methods such as {@link #ensureOnScreen(java.awt.Rectangle)}, {@link
     * #getContainingScreenBounds(java.awt.Rectangle, boolean)} or {@link #getScreenArea()} for the first time, it will
     * take up to a few seconds to run because it needs to get device information. To avoid any slowness, you can call
     * call this method in the class where you will use those three methods. This method will spawn a thread to retrieve
     * device information thus it will return immediately. Hopefully, when you use the three methods, the thread is done
     * so user will not notice any slowness.
     * @deprecated Call GraphicsEnvironment.getLocalGraphicsEnvironment().getScreenDevices()
     */
    @Deprecated
    synchronized public static void initializeScreenArea() {
        initializeScreenArea(Thread.NORM_PRIORITY);
    }

    /**
     * If you use methods such as {@link #ensureOnScreen(java.awt.Rectangle)}, {@link
     * #getContainingScreenBounds(java.awt.Rectangle, boolean)} or {@link #getScreenArea()} for the first time, it will
     * take up to a couple of seconds to run because it needs to get device information. To avoid any slowness, you can
     * call {@link #initializeScreenArea()} method in the class where you will use those three methods. This method will
     * spawn a thread to retrieve device information thus it will return immediately. Hopefully, when you use the three
     * methods, the thread is done so user will not notice any slowness.
     *
     * @param priority as we will use a thread to calculate the screen area, you can use this parameter to control the
     *                 priority of the thread. If you are waiting for the result before the next step, you should use
     *                 normal priority (which is 5). If you just want to calculate when app starts, you can use a lower
     *                 priority (such as 3). For example, AbstractComboBox needs screen size so that the popup doesn't
     *                 go beyond the screen. So when AbstractComboBox is used, we will kick off the thread at priority
     *                 3. If user clicks on the drop down after the thread finished, there will be no time delay.
     * @deprecated Call GraphicsEnvironment.getLocalGraphicsEnvironment().getScreenDevices()
     */
    @Deprecated
    synchronized public static void initializeScreenArea(int priority) {
        final Thread _initializationThread = new Thread() {
            @Override
            public void run() {
                GraphicsEnvironment.getLocalGraphicsEnvironment().getScreenDevices();
            }
        };

        _initializationThread.setPriority(priority);
        if (INITIALIZE_SCREEN_AREA_USING_THREAD) {
            _initializationThread.start();
        } else {
            _initializationThread.run();
        }
    }
}