comparison dwt/graphics/Drawable.d @ 0:380af2bdd8e5

Upload of whole dwt tree
author Jacob Carlborg <doob@me.com> <jacob.carlborg@gmail.com>
date Sat, 09 Aug 2008 17:00:02 +0200
parents
children e831403a80a9
comparison
equal deleted inserted replaced
-1:000000000000 0:380af2bdd8e5
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 *******************************************************************************/
11 module dwt.graphics.Drawable;
12
13 import dwt.dwthelper.utils;
14
15
16 /**
17 * Implementers of <code>Drawable</code> can have a graphics context (GC)
18 * created for them, and then they can be drawn on by sending messages to
19 * their associated GC. DWT images, and device objects such as the Display
20 * device and the Printer device, are drawables.
21 * <p>
22 * <b>IMPORTANT:</b> This class is <em>not</em> part of the DWT
23 * public API. It is marked public only so that it can be shared
24 * within the packages provided by DWT. It should never be
25 * referenced from application code.
26 * </p>
27 *
28 * @see Device
29 * @see Image
30 * @see GC
31 */
32 public interface Drawable {
33
34 /**
35 * Invokes platform specific functionality to allocate a new GC handle.
36 * <p>
37 * <b>IMPORTANT:</b> This method is <em>not</em> part of the public
38 * API for <code>Drawable</code>. It is marked public only so that it
39 * can be shared within the packages provided by DWT. It is not
40 * available on all platforms, and should never be called from
41 * application code.
42 * </p>
43 *
44 * @param data the platform specific GC data
45 * @return the platform specific GC handle
46 */
47
48 public int /*long*/ internal_new_GC (GCData data);
49
50 /**
51 * Invokes platform specific functionality to dispose a GC handle.
52 * <p>
53 * <b>IMPORTANT:</b> This method is <em>not</em> part of the public
54 * API for <code>Drawable</code>. It is marked public only so that it
55 * can be shared within the packages provided by DWT. It is not
56 * available on all platforms, and should never be called from
57 * application code.
58 * </p>
59 *
60 * @param handle the platform specific GC handle
61 * @param data the platform specific GC data
62 */
63 public void internal_dispose_GC (int /*long*/ handle, GCData data);
64
65 }