1 /*******************************************************************************

     2  * Copyright (c) 2000, 2004 IBM Corporation and others.

     3  * All rights reserved. This program and the accompanying materials

     4  * are made available under the terms of the Eclipse Public License v1.0

     5  * which accompanies this distribution, and is available at

     6  * http://www.eclipse.org/legal/epl-v10.html

     7  *

     8  * Contributors:

     9  *     IBM Corporation - initial API and implementation

    10  *     Nokia Corporation - QT implementation

    11  *******************************************************************************/

    12 package org.eclipse.swt.graphics;

    13 

    14 import org.eclipse.swt.internal.qt.GCData;

    15 

    16 

    17 /**

    18  * Implementers of <code>Drawable</code> can have a graphics context (GC)

    19  * created for them, and then they can be drawn on by sending messages to

    20  * their associated GC. SWT images, and device objects such as the Display

    21  * device and the Printer device, are drawables.

    22  * <p>

    23  * <b>IMPORTANT:</b> This class is <em>not</em> part of the SWT

    24  * public API. It is marked public only so that it can be shared

    25  * within the packages provided by SWT. It should never be

    26  * referenced from application code.

    27  * </p>

    28  * 

    29  * @see Device

    30  * @see Image

    31  * @see GC

    32  */

    33 public interface Drawable {

    34 

    35 /**	 

    36  * Invokes platform specific functionality to allocate a new GC.

    37  * <p>

    38  * <b>IMPORTANT:</b> This method is <em>not</em> part of the public

    39  * API for <code>Drawable</code>. It is marked public only so that it

    40  * can be shared within the packages provided by SWT. It is not

    41  * available on all platforms, and should never be called from

    42  * application code.

    43  * </p>

    44  *

    45  * @param data the platform specific GC data 

    46  * @return the platform specific GC handle

    47  */

    48  

    49 public int internal_new_GC(GCData data);

    50 

    51 /**	 

    52  * Invokes platform specific functionality to dispose a GC.

    53  * <p>

    54  * <b>IMPORTANT:</b> This method is <em>not</em> part of the public

    55  * API for <code>Drawable</code>. It is marked public only so that it

    56  * can be shared within the packages provided by SWT. It is not

    57  * available on all platforms, and should never be called from

    58  * application code.

    59  * </p>

    60  *

    61  * @param data the platform specific GC data 

    62  */

    63 public void internal_dispose_GC(GCData data);

    64 

    65 }