org.eclipse.jface.resource.DeviceResourceManager Maven / Gradle / Ivy

Go to download

Show more of this group Show more artifacts with this name
Show all versions of org.eclipse.jface Show documentation

This is org.eclipse.jface jar used by Scout SDK

The newest version!

/*******************************************************************************
 * Copyright (c) 2004, 2015 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 *
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.jface.resource;

import org.eclipse.swt.graphics.Device;
import org.eclipse.swt.graphics.Image;

/**
 * Manages SWT resources for a particular device.
 *
 * 
 * IMPORTANT: in most cases clients should use a LocalResourceManager instead of a
 * DeviceResourceManager. To create a resource manager on a particular display,
 * use new LocalResourceManager(JFaceResources.getResources(myDisplay)).
 * DeviceResourceManager should only be used directly when managing
 * resources for a device other than a Display (such as a printer).
 * 
 *
 * @see LocalResourceManager
 *
 * @since 3.1
 */
public final class DeviceResourceManager extends AbstractResourceManager {

    private Device device;
    private Image missingImage;

    @Override
	public Device getDevice() {
        return device;
    }

    /**
     * Creates a new registry for the given device.
     *
     * @param device device to manage
     */
    public DeviceResourceManager(Device device) {
        this.device = device;
    }

    @Override
	protected Object allocate(DeviceResourceDescriptor descriptor) throws DeviceResourceException {
        return descriptor.createResource(device);
    }

    @Override
	protected void deallocate(Object resource, DeviceResourceDescriptor descriptor) {
        descriptor.destroyResource(resource);
    }

    @Override
	protected Image getDefaultImage() {
        if (missingImage == null) {
            missingImage = ImageDescriptor.getMissingImageDescriptor().createImage();
        }
        return missingImage;
    }

    @Override
	public void dispose() {
        super.dispose();
        if (missingImage != null) {
            missingImage.dispose();
            missingImage = null;
        }
    }
}