1 /* 2 * This file is part of gtkD. 3 * 4 * gtkD is free software; you can redistribute it and/or modify 5 * it under the terms of the GNU Lesser General Public License 6 * as published by the Free Software Foundation; either version 3 7 * of the License, or (at your option) any later version, with 8 * some exceptions, please read the COPYING file. 9 * 10 * gtkD is distributed in the hope that it will be useful, 11 * but WITHOUT ANY WARRANTY; without even the implied warranty of 12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 13 * GNU Lesser General Public License for more details. 14 * 15 * You should have received a copy of the GNU Lesser General Public License 16 * along with gtkD; if not, write to the Free Software 17 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110, USA 18 */ 19 20 // generated automatically - do not change 21 // find conversion definition on APILookup.txt 22 // implement new conversion functionalities on the wrap.utils pakage 23 24 25 module atk.ImageIF; 26 27 private import glib.Str; 28 private import gtkc.atk; 29 public import gtkc.atktypes; 30 31 32 /** 33 * #AtkImage should be implemented by #AtkObject subtypes on behalf of 34 * components which display image/pixmap information onscreen, and 35 * which provide information (other than just widget borders, etc.) 36 * via that image content. For instance, icons, buttons with icons, 37 * toolbar elements, and image viewing panes typically should 38 * implement #AtkImage. 39 * 40 * #AtkImage primarily provides two types of information: coordinate 41 * information (useful for screen review mode of screenreaders, and 42 * for use by onscreen magnifiers), and descriptive information. The 43 * descriptive information is provided for alternative, text-only 44 * presentation of the most significant information present in the 45 * image. 46 */ 47 public interface ImageIF{ 48 /** Get the main Gtk struct */ 49 public AtkImage* getImageStruct(); 50 51 /** the main Gtk struct as a void* */ 52 protected void* getStruct(); 53 54 /** 55 */ 56 57 /** 58 * Get a textual description of this image. 59 * 60 * Return: a string representing the image description 61 */ 62 public string getImageDescription(); 63 64 /** 65 * Since ATK 1.12 66 * 67 * Return: a string corresponding to the POSIX 68 * LC_MESSAGES locale used by the image description, or %NULL if the 69 * image does not specify a locale. 70 */ 71 public string getImageLocale(); 72 73 /** 74 * Gets the position of the image in the form of a point specifying the 75 * images top-left corner. 76 * 77 * Params: 78 * x = address of #gint to put x coordinate position; otherwise, -1 if value cannot be obtained. 79 * y = address of #gint to put y coordinate position; otherwise, -1 if value cannot be obtained. 80 * coordType = specifies whether the coordinates are relative to the screen 81 * or to the components top level window 82 */ 83 public void getImagePosition(int* x, int* y, AtkCoordType coordType); 84 85 /** 86 * Get the width and height in pixels for the specified image. 87 * The values of @width and @height are returned as -1 if the 88 * values cannot be obtained (for instance, if the object is not onscreen). 89 * 90 * Params: 91 * width = filled with the image width, or -1 if the value cannot be obtained. 92 * height = filled with the image height, or -1 if the value cannot be obtained. 93 */ 94 public void getImageSize(int* width, int* height); 95 96 /** 97 * Sets the textual description for this image. 98 * 99 * Params: 100 * description = a string description to set for @image 101 * 102 * Return: boolean TRUE, or FALSE if operation could 103 * not be completed. 104 */ 105 public bool setImageDescription(string description); 106 }