Mercurial > projects > dwt-linux
view dwt/widgets/TabItem.d @ 150:f2e04420fd6c
reworked overrides and superclass aliases
author | Frank Benoit <benoit@tionex.de> |
---|---|
date | Thu, 31 Jan 2008 19:04:56 +0100 |
parents | 0f12f6bb9739 |
children | 17f8449522fd |
line wrap: on
line source
/******************************************************************************* * Copyright (c) 2000, 2007 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 * Port to the D programming language: * Frank Benoit <benoit@tionex.de> *******************************************************************************/ module dwt.widgets.TabItem; import dwt.DWT; import dwt.DWTException; import dwt.graphics.Image; import dwt.internal.gtk.OS; import dwt.widgets.Item; import dwt.widgets.Control; import dwt.widgets.TabFolder; import dwt.widgets.ImageList; static import tango.stdc.stringz; /** * Instances of this class represent a selectable user interface object * corresponding to a tab for a page in a tab folder. * <dl> * <dt><b>Styles:</b></dt> * <dd>(none)</dd> * <dt><b>Events:</b></dt> * <dd>(none)</dd> * </dl> * <p> * IMPORTANT: This class is <em>not</em> intended to be subclassed. * </p> */ public class TabItem : Item { alias Item.setForegroundColor setForegroundColor; GtkWidget* labelHandle, imageHandle, pageHandle; Control control; TabFolder parent; char[] toolTipText; /** * Constructs a new instance of this class given its parent * (which must be a <code>TabFolder</code>) and a style value * describing its behavior and appearance. The item is added * to the end of the items maintained by its parent. * <p> * The style value is either one of the style constants defined in * class <code>DWT</code> which is applicable to instances of this * class, or must be built by <em>bitwise OR</em>'ing together * (that is, using the <code>int</code> "|" operator) two or more * of those <code>DWT</code> style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. * </p> * * @param parent a composite control which will be the parent of the new instance (cannot be null) * @param style the style of control to construct * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * </ul> * @exception DWTException <ul> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li> * <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li> * </ul> * * @see DWT * @see Widget#checkSubclass * @see Widget#getStyle */ public this (TabFolder parent, int style) { super (parent, style); this.parent = parent; createWidget (parent.getItemCount ()); } /** * Constructs a new instance of this class given its parent * (which must be a <code>TabFolder</code>), a style value * describing its behavior and appearance, and the index * at which to place it in the items maintained by its parent. * <p> * The style value is either one of the style constants defined in * class <code>DWT</code> which is applicable to instances of this * class, or must be built by <em>bitwise OR</em>'ing together * (that is, using the <code>int</code> "|" operator) two or more * of those <code>DWT</code> style constants. The class description * lists the style constants that are applicable to the class. * Style bits are also inherited from superclasses. * </p> * * @param parent a composite control which will be the parent of the new instance (cannot be null) * @param style the style of control to construct * @param index the zero-relative index to store the receiver in its parent * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the parent is null</li> * <li>ERROR_INVALID_RANGE - if the index is not between 0 and the number of elements in the parent (inclusive)</li> * </ul> * @exception DWTException <ul> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the parent</li> * <li>ERROR_INVALID_SUBCLASS - if this class is not an allowed subclass</li> * </ul> * * @see DWT * @see Widget#checkSubclass * @see Widget#getStyle */ public this (TabFolder parent, int style, int index) { super (parent, style); this.parent = parent; createWidget (index); } protected void checkSubclass () { if (!isValidSubclass ()) error (DWT.ERROR_INVALID_SUBCLASS); } void createWidget (int index) { parent.createItem (this, index); setOrientation (); hookEvents (); register (); text = ""; } void deregister() { super.deregister (); if (labelHandle !is null) display.removeWidget (labelHandle); } void destroyWidget () { parent.destroyItem (this); releaseHandle (); } /** * Returns the control that is used to fill the client area of * the tab folder when the user selects the tab item. If no * control has been set, return <code>null</code>. * <p> * @return the control * * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public Control getControl () { checkWidget (); return control; } /** * Returns the receiver's parent, which must be a <code>TabFolder</code>. * * @return the receiver's parent * * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public TabFolder getParent () { checkWidget (); return parent; } /** * Returns the receiver's tool tip text, or null if it has * not been set. * * @return the receiver's tool tip text * * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public char[] getToolTipText () { checkWidget (); return toolTipText; } override int gtk_enter_notify_event (GtkWidget* widget, GdkEventCrossing* event) { parent.gtk_enter_notify_event (widget, event); return 0; } override int gtk_mnemonic_activate (GtkWidget* widget, int /*long*/ arg1) { return parent.gtk_mnemonic_activate (widget, arg1); } void hookEvents () { super.hookEvents (); if (labelHandle !is null) OS.g_signal_connect_closure_by_id (labelHandle, display.signalIds [MNEMONIC_ACTIVATE], 0, display.closures [MNEMONIC_ACTIVATE], false); OS.g_signal_connect_closure_by_id (handle, display.signalIds [ENTER_NOTIFY_EVENT], 0, display.closures [ENTER_NOTIFY_EVENT], false); } void register () { super.register (); if (labelHandle !is null) display.addWidget (labelHandle, this); } void releaseHandle () { super.releaseHandle (); pageHandle = labelHandle = imageHandle = null; parent = null; } void releaseParent () { super.releaseParent (); int index = parent.indexOf (this); if (index is parent.getSelectionIndex ()) { if (control !is null) control.setVisible (false); } } /** * Sets the control that is used to fill the client area of * the tab folder when the user selects the tab item. * <p> * @param control the new control (or null) * * @exception IllegalArgumentException <ul> * <li>ERROR_INVALID_ARGUMENT - if the control has been disposed</li> * <li>ERROR_INVALID_PARENT - if the control is not in the same widget tree</li> * </ul> * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setControl (Control control) { checkWidget (); if (control !is null) { if (control.isDisposed ()) error (DWT.ERROR_INVALID_ARGUMENT); if (control.parent !is parent) error (DWT.ERROR_INVALID_PARENT); } Control oldControl = this.control, newControl = control; this.control = control; int index = parent.indexOf (this); if (index !is parent.getSelectionIndex ()) { if (newControl !is null) newControl.setVisible (false); return; } if (newControl !is null) { newControl.setBounds (parent.getClientArea ()); newControl.setVisible (true); } if (oldControl !is null) oldControl.setVisible (false); } void setFontDescription (PangoFontDescription* font) { OS.gtk_widget_modify_font (labelHandle, font); OS.gtk_widget_modify_font (imageHandle, font); } alias Item.setForegroundColor setForegroundColor; void setForegroundColor (GdkColor* color) { /* Don't set the color in vbox handle (it doesn't draw) */ setForegroundColor (labelHandle, color); setForegroundColor (imageHandle, color); } public override void setImage (Image image) { checkWidget (); super.setImage (image); if (image !is null) { ImageList imageList = parent.imageList; if (imageList is null) imageList = parent.imageList = new ImageList (); int imageIndex = imageList.indexOf (image); if (imageIndex is -1) { imageIndex = imageList.add (image); } else { imageList.put (imageIndex, image); } auto pixbuf = imageList.getPixbuf (imageIndex); OS.gtk_image_set_from_pixbuf (imageHandle, pixbuf); OS.gtk_widget_show (imageHandle); } else { OS.gtk_image_set_from_pixbuf (imageHandle, null); OS.gtk_widget_hide (imageHandle); } } void setOrientation () { if ((parent.style & DWT.RIGHT_TO_LEFT) !is 0) { if (handle !is null) OS.gtk_widget_set_direction (handle, OS.GTK_TEXT_DIR_RTL); if (labelHandle !is null) OS.gtk_widget_set_direction (labelHandle, OS.GTK_TEXT_DIR_RTL); if (imageHandle !is null) OS.gtk_widget_set_direction (imageHandle, OS.GTK_TEXT_DIR_RTL); if (pageHandle !is null) OS.gtk_widget_set_direction (pageHandle, OS.GTK_TEXT_DIR_RTL); } } /** * Sets the receiver's text. The string may include * the mnemonic character. * </p> * <p> * Mnemonics are indicated by an '&' that causes the next * character to be the mnemonic. When the user presses a * key sequence that matches the mnemonic, a selection * event occurs. On most platforms, the mnemonic appears * underlined but may be emphasised in a platform specific * manner. The mnemonic indicator character '&' can be * escaped by doubling it in the string, causing a single * '&' to be displayed. * </p> * * @param string the new text * * @exception IllegalArgumentException <ul> * <li>ERROR_NULL_ARGUMENT - if the text is null</li> * </ul> * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> * */ public override void setText (char[] string) { checkWidget (); if (string is null) error (DWT.ERROR_NULL_ARGUMENT); super.setText (string); char [] chars = fixMnemonic (string); char* buffer = tango.stdc.stringz.toStringz( chars); OS.gtk_label_set_text_with_mnemonic (labelHandle, buffer); if (string.length !is 0) { OS.gtk_widget_show (labelHandle); } else { OS.gtk_widget_hide (labelHandle); } } /** * Sets the receiver's tool tip text to the argument, which * may be null indicating that no tool tip text should be shown. * * @param string the new tool tip text (or null) * * @exception DWTException <ul> * <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li> * <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li> * </ul> */ public void setToolTipText (char[] string) { checkWidget (); toolTipText = string; } }