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 gtk.CellArea; 26 27 private import cairo.Context; 28 private import gdk.Event; 29 private import glib.ListG; 30 private import glib.Str; 31 private import gobject.ObjectG; 32 private import gobject.Signals; 33 private import gobject.Value; 34 private import gtk.BuildableIF; 35 private import gtk.BuildableT; 36 private import gtk.CellAreaContext; 37 private import gtk.CellEditable; 38 private import gtk.CellEditableIF; 39 private import gtk.CellLayoutIF; 40 private import gtk.CellLayoutT; 41 private import gtk.CellRenderer; 42 private import gtk.TreeIter; 43 private import gtk.TreeModel; 44 private import gtk.TreeModelIF; 45 private import gtk.Widget; 46 public import gtkc.gdktypes; 47 private import gtkc.gtk; 48 public import gtkc.gtktypes; 49 50 51 /** 52 * The #GtkCellArea is an abstract class for #GtkCellLayout widgets 53 * (also referred to as "layouting widgets") to interface with an 54 * arbitrary number of #GtkCellRenderers and interact with the user 55 * for a given #GtkTreeModel row. 56 * 57 * The cell area handles events, focus navigation, drawing and 58 * size requests and allocations for a given row of data. 59 * 60 * Usually users dont have to interact with the #GtkCellArea directly 61 * unless they are implementing a cell-layouting widget themselves. 62 * 63 * # Requesting area sizes 64 * 65 * As outlined in 66 * [GtkWidget’s geometry management section][geometry-management], 67 * GTK+ uses a height-for-width 68 * geometry management system to compute the sizes of widgets and user 69 * interfaces. #GtkCellArea uses the same semantics to calculate the 70 * size of an area for an arbitrary number of #GtkTreeModel rows. 71 * 72 * When requesting the size of a cell area one needs to calculate 73 * the size for a handful of rows, and this will be done differently by 74 * different layouting widgets. For instance a #GtkTreeViewColumn 75 * always lines up the areas from top to bottom while a #GtkIconView 76 * on the other hand might enforce that all areas received the same 77 * width and wrap the areas around, requesting height for more cell 78 * areas when allocated less width. 79 * 80 * It’s also important for areas to maintain some cell 81 * alignments with areas rendered for adjacent rows (cells can 82 * appear “columnized” inside an area even when the size of 83 * cells are different in each row). For this reason the #GtkCellArea 84 * uses a #GtkCellAreaContext object to store the alignments 85 * and sizes along the way (as well as the overall largest minimum 86 * and natural size for all the rows which have been calculated 87 * with the said context). 88 * 89 * The #GtkCellAreaContext is an opaque object specific to the 90 * #GtkCellArea which created it (see gtk_cell_area_create_context()). 91 * The owning cell-layouting widget can create as many contexts as 92 * it wishes to calculate sizes of rows which should receive the 93 * same size in at least one orientation (horizontally or vertically), 94 * However, it’s important that the same #GtkCellAreaContext which 95 * was used to request the sizes for a given #GtkTreeModel row be 96 * used when rendering or processing events for that row. 97 * 98 * In order to request the width of all the rows at the root level 99 * of a #GtkTreeModel one would do the following: 100 * 101 * |[<!-- language="C" --> 102 * GtkTreeIter iter; 103 * gint minimum_width; 104 * gint natural_width; 105 * 106 * valid = gtk_tree_model_get_iter_first (model, &iter); 107 * while (valid) 108 * { 109 * gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE); 110 * gtk_cell_area_get_preferred_width (area, context, widget, NULL, NULL); 111 * 112 * valid = gtk_tree_model_iter_next (model, &iter); 113 * } 114 * gtk_cell_area_context_get_preferred_width (context, &minimum_width, &natural_width); 115 * ]| 116 * 117 * Note that in this example it’s not important to observe the 118 * returned minimum and natural width of the area for each row 119 * unless the cell-layouting object is actually interested in the 120 * widths of individual rows. The overall width is however stored 121 * in the accompanying #GtkCellAreaContext object and can be consulted 122 * at any time. 123 * 124 * This can be useful since #GtkCellLayout widgets usually have to 125 * support requesting and rendering rows in treemodels with an 126 * exceedingly large amount of rows. The #GtkCellLayout widget in 127 * that case would calculate the required width of the rows in an 128 * idle or timeout source (see g_timeout_add()) and when the widget 129 * is requested its actual width in #GtkWidgetClass.get_preferred_width() 130 * it can simply consult the width accumulated so far in the 131 * #GtkCellAreaContext object. 132 * 133 * A simple example where rows are rendered from top to bottom and 134 * take up the full width of the layouting widget would look like: 135 * 136 * |[<!-- language="C" --> 137 * static void 138 * foo_get_preferred_width (GtkWidget *widget, 139 * gint *minimum_size, 140 * gint *natural_size) 141 * { 142 * Foo *foo = FOO (widget); 143 * FooPrivate *priv = foo->priv; 144 * 145 * foo_ensure_at_least_one_handfull_of_rows_have_been_requested (foo); 146 * 147 * gtk_cell_area_context_get_preferred_width (priv->context, minimum_size, natural_size); 148 * } 149 * ]| 150 * 151 * In the above example the Foo widget has to make sure that some 152 * row sizes have been calculated (the amount of rows that Foo judged 153 * was appropriate to request space for in a single timeout iteration) 154 * before simply returning the amount of space required by the area via 155 * the #GtkCellAreaContext. 156 * 157 * Requesting the height for width (or width for height) of an area is 158 * a similar task except in this case the #GtkCellAreaContext does not 159 * store the data (actually, it does not know how much space the layouting 160 * widget plans to allocate it for every row. It’s up to the layouting 161 * widget to render each row of data with the appropriate height and 162 * width which was requested by the #GtkCellArea). 163 * 164 * In order to request the height for width of all the rows at the 165 * root level of a #GtkTreeModel one would do the following: 166 * 167 * |[<!-- language="C" --> 168 * GtkTreeIter iter; 169 * gint minimum_height; 170 * gint natural_height; 171 * gint full_minimum_height = 0; 172 * gint full_natural_height = 0; 173 * 174 * valid = gtk_tree_model_get_iter_first (model, &iter); 175 * while (valid) 176 * { 177 * gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE); 178 * gtk_cell_area_get_preferred_height_for_width (area, context, widget, 179 * width, &minimum_height, &natural_height); 180 * 181 * if (width_is_for_allocation) 182 * cache_row_height (&iter, minimum_height, natural_height); 183 * 184 * full_minimum_height += minimum_height; 185 * full_natural_height += natural_height; 186 * 187 * valid = gtk_tree_model_iter_next (model, &iter); 188 * } 189 * ]| 190 * 191 * Note that in the above example we would need to cache the heights 192 * returned for each row so that we would know what sizes to render the 193 * areas for each row. However we would only want to really cache the 194 * heights if the request is intended for the layouting widgets real 195 * allocation. 196 * 197 * In some cases the layouting widget is requested the height for an 198 * arbitrary for_width, this is a special case for layouting widgets 199 * who need to request size for tens of thousands of rows. For this 200 * case it’s only important that the layouting widget calculate 201 * one reasonably sized chunk of rows and return that height 202 * synchronously. The reasoning here is that any layouting widget is 203 * at least capable of synchronously calculating enough height to fill 204 * the screen height (or scrolled window height) in response to a single 205 * call to #GtkWidgetClass.get_preferred_height_for_width(). Returning 206 * a perfect height for width that is larger than the screen area is 207 * inconsequential since after the layouting receives an allocation 208 * from a scrolled window it simply continues to drive the scrollbar 209 * values while more and more height is required for the row heights 210 * that are calculated in the background. 211 * 212 * # Rendering Areas 213 * 214 * Once area sizes have been aquired at least for the rows in the 215 * visible area of the layouting widget they can be rendered at 216 * #GtkWidgetClass.draw() time. 217 * 218 * A crude example of how to render all the rows at the root level 219 * runs as follows: 220 * 221 * |[<!-- language="C" --> 222 * GtkAllocation allocation; 223 * GdkRectangle cell_area = { 0, }; 224 * GtkTreeIter iter; 225 * gint minimum_width; 226 * gint natural_width; 227 * 228 * gtk_widget_get_allocation (widget, &allocation); 229 * cell_area.width = allocation.width; 230 * 231 * valid = gtk_tree_model_get_iter_first (model, &iter); 232 * while (valid) 233 * { 234 * cell_area.height = get_cached_height_for_row (&iter); 235 * 236 * gtk_cell_area_apply_attributes (area, model, &iter, FALSE, FALSE); 237 * gtk_cell_area_render (area, context, widget, cr, 238 * &cell_area, &cell_area, state_flags, FALSE); 239 * 240 * cell_area.y += cell_area.height; 241 * 242 * valid = gtk_tree_model_iter_next (model, &iter); 243 * } 244 * ]| 245 * 246 * Note that the cached height in this example really depends on how 247 * the layouting widget works. The layouting widget might decide to 248 * give every row its minimum or natural height or, if the model content 249 * is expected to fit inside the layouting widget without scrolling, it 250 * would make sense to calculate the allocation for each row at 251 * #GtkWidget::size-allocate time using gtk_distribute_natural_allocation(). 252 * 253 * # Handling Events and Driving Keyboard Focus 254 * 255 * Passing events to the area is as simple as handling events on any 256 * normal widget and then passing them to the gtk_cell_area_event() 257 * API as they come in. Usually #GtkCellArea is only interested in 258 * button events, however some customized derived areas can be implemented 259 * who are interested in handling other events. Handling an event can 260 * trigger the #GtkCellArea::focus-changed signal to fire; as well as 261 * #GtkCellArea::add-editable in the case that an editable cell was 262 * clicked and needs to start editing. You can call 263 * gtk_cell_area_stop_editing() at any time to cancel any cell editing 264 * that is currently in progress. 265 * 266 * The #GtkCellArea drives keyboard focus from cell to cell in a way 267 * similar to #GtkWidget. For layouting widgets that support giving 268 * focus to cells it’s important to remember to pass %GTK_CELL_RENDERER_FOCUSED 269 * to the area functions for the row that has focus and to tell the 270 * area to paint the focus at render time. 271 * 272 * Layouting widgets that accept focus on cells should implement the 273 * #GtkWidgetClass.focus() virtual method. The layouting widget is always 274 * responsible for knowing where #GtkTreeModel rows are rendered inside 275 * the widget, so at #GtkWidgetClass.focus() time the layouting widget 276 * should use the #GtkCellArea methods to navigate focus inside the area 277 * and then observe the GtkDirectionType to pass the focus to adjacent 278 * rows and areas. 279 * 280 * A basic example of how the #GtkWidgetClass.focus() virtual method 281 * should be implemented: 282 * 283 * |[<!-- language="C" --> 284 * static gboolean 285 * foo_focus (GtkWidget *widget, 286 * GtkDirectionType direction) 287 * { 288 * Foo *foo = FOO (widget); 289 * FooPrivate *priv = foo->priv; 290 * gint focus_row; 291 * gboolean have_focus = FALSE; 292 * 293 * focus_row = priv->focus_row; 294 * 295 * if (!gtk_widget_has_focus (widget)) 296 * gtk_widget_grab_focus (widget); 297 * 298 * valid = gtk_tree_model_iter_nth_child (priv->model, &iter, NULL, priv->focus_row); 299 * while (valid) 300 * { 301 * gtk_cell_area_apply_attributes (priv->area, priv->model, &iter, FALSE, FALSE); 302 * 303 * if (gtk_cell_area_focus (priv->area, direction)) 304 * { 305 * priv->focus_row = focus_row; 306 * have_focus = TRUE; 307 * break; 308 * } 309 * else 310 * { 311 * if (direction == GTK_DIR_RIGHT || 312 * direction == GTK_DIR_LEFT) 313 * break; 314 * else if (direction == GTK_DIR_UP || 315 * direction == GTK_DIR_TAB_BACKWARD) 316 * { 317 * if (focus_row == 0) 318 * break; 319 * else 320 * { 321 * focus_row--; 322 * valid = gtk_tree_model_iter_nth_child (priv->model, &iter, NULL, focus_row); 323 * } 324 * } 325 * else 326 * { 327 * if (focus_row == last_row) 328 * break; 329 * else 330 * { 331 * focus_row++; 332 * valid = gtk_tree_model_iter_next (priv->model, &iter); 333 * } 334 * } 335 * } 336 * } 337 * return have_focus; 338 * } 339 * ]| 340 * 341 * Note that the layouting widget is responsible for matching the 342 * GtkDirectionType values to the way it lays out its cells. 343 * 344 * # Cell Properties 345 * 346 * The #GtkCellArea introduces cell properties for #GtkCellRenderers 347 * in very much the same way that #GtkContainer introduces 348 * [child properties][child-properties] 349 * for #GtkWidgets. This provides some general interfaces for defining 350 * the relationship cell areas have with their cells. For instance in a 351 * #GtkCellAreaBox a cell might “expand” and receive extra space when 352 * the area is allocated more than its full natural request, or a cell 353 * might be configured to “align” with adjacent rows which were requested 354 * and rendered with the same #GtkCellAreaContext. 355 * 356 * Use gtk_cell_area_class_install_cell_property() to install cell 357 * properties for a cell area class and gtk_cell_area_class_find_cell_property() 358 * or gtk_cell_area_class_list_cell_properties() to get information about 359 * existing cell properties. 360 * 361 * To set the value of a cell property, use gtk_cell_area_cell_set_property(), 362 * gtk_cell_area_cell_set() or gtk_cell_area_cell_set_valist(). To obtain 363 * the value of a cell property, use gtk_cell_area_cell_get_property(), 364 * gtk_cell_area_cell_get() or gtk_cell_area_cell_get_valist(). 365 */ 366 public class CellArea : ObjectG, BuildableIF, CellLayoutIF 367 { 368 /** the main Gtk struct */ 369 protected GtkCellArea* gtkCellArea; 370 371 /** Get the main Gtk struct */ 372 public GtkCellArea* getCellAreaStruct() 373 { 374 return gtkCellArea; 375 } 376 377 /** the main Gtk struct as a void* */ 378 protected override void* getStruct() 379 { 380 return cast(void*)gtkCellArea; 381 } 382 383 protected override void setStruct(GObject* obj) 384 { 385 gtkCellArea = cast(GtkCellArea*)obj; 386 super.setStruct(obj); 387 } 388 389 /** 390 * Sets our main struct and passes it to the parent class. 391 */ 392 public this (GtkCellArea* gtkCellArea, bool ownedRef = false) 393 { 394 this.gtkCellArea = gtkCellArea; 395 super(cast(GObject*)gtkCellArea, ownedRef); 396 } 397 398 // add the Buildable capabilities 399 mixin BuildableT!(GtkCellArea); 400 401 // add the CellLayout capabilities 402 mixin CellLayoutT!(GtkCellArea); 403 404 405 /** */ 406 public static GType getType() 407 { 408 return gtk_cell_area_get_type(); 409 } 410 411 /** 412 * Activates @area, usually by activating the currently focused 413 * cell, however some subclasses which embed widgets in the area 414 * can also activate a widget if it currently has the focus. 415 * 416 * Params: 417 * context = the #GtkCellAreaContext in context with the current row data 418 * widget = the #GtkWidget that @area is rendering on 419 * cellArea = the size and location of @area relative to @widget’s allocation 420 * flags = the #GtkCellRendererState flags for @area for this row of data. 421 * editOnly = if %TRUE then only cell renderers that are %GTK_CELL_RENDERER_MODE_EDITABLE 422 * will be activated. 423 * 424 * Return: Whether @area was successfully activated. 425 * 426 * Since: 3.0 427 */ 428 public bool activate(CellAreaContext context, Widget widget, GdkRectangle* cellArea, GtkCellRendererState flags, bool editOnly) 429 { 430 return gtk_cell_area_activate(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), cellArea, flags, editOnly) != 0; 431 } 432 433 /** 434 * This is used by #GtkCellArea subclasses when handling events 435 * to activate cells, the base #GtkCellArea class activates cells 436 * for keyboard events for free in its own GtkCellArea->activate() 437 * implementation. 438 * 439 * Params: 440 * widget = the #GtkWidget that @area is rendering onto 441 * renderer = the #GtkCellRenderer in @area to activate 442 * event = the #GdkEvent for which cell activation should occur 443 * cellArea = the #GdkRectangle in @widget relative coordinates 444 * of @renderer for the current row. 445 * flags = the #GtkCellRendererState for @renderer 446 * 447 * Return: whether cell activation was successful 448 * 449 * Since: 3.0 450 */ 451 public bool activateCell(Widget widget, CellRenderer renderer, Event event, GdkRectangle* cellArea, GtkCellRendererState flags) 452 { 453 return gtk_cell_area_activate_cell(gtkCellArea, (widget is null) ? null : widget.getWidgetStruct(), (renderer is null) ? null : renderer.getCellRendererStruct(), (event is null) ? null : event.getEventStruct(), cellArea, flags) != 0; 454 } 455 456 /** 457 * Adds @renderer to @area with the default child cell properties. 458 * 459 * Params: 460 * renderer = the #GtkCellRenderer to add to @area 461 * 462 * Since: 3.0 463 */ 464 public void add(CellRenderer renderer) 465 { 466 gtk_cell_area_add(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct()); 467 } 468 469 /** 470 * Adds @sibling to @renderer’s focusable area, focus will be drawn 471 * around @renderer and all of its siblings if @renderer can 472 * focus for a given row. 473 * 474 * Events handled by focus siblings can also activate the given 475 * focusable @renderer. 476 * 477 * Params: 478 * renderer = the #GtkCellRenderer expected to have focus 479 * sibling = the #GtkCellRenderer to add to @renderer’s focus area 480 * 481 * Since: 3.0 482 */ 483 public void addFocusSibling(CellRenderer renderer, CellRenderer sibling) 484 { 485 gtk_cell_area_add_focus_sibling(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), (sibling is null) ? null : sibling.getCellRendererStruct()); 486 } 487 488 /** 489 * Applies any connected attributes to the renderers in 490 * @area by pulling the values from @tree_model. 491 * 492 * Params: 493 * treeModel = the #GtkTreeModel to pull values from 494 * iter = the #GtkTreeIter in @tree_model to apply values for 495 * isExpander = whether @iter has children 496 * isExpanded = whether @iter is expanded in the view and 497 * children are visible 498 * 499 * Since: 3.0 500 */ 501 public void applyAttributes(TreeModelIF treeModel, TreeIter iter, bool isExpander, bool isExpanded) 502 { 503 gtk_cell_area_apply_attributes(gtkCellArea, (treeModel is null) ? null : treeModel.getTreeModelStruct(), (iter is null) ? null : iter.getTreeIterStruct(), isExpander, isExpanded); 504 } 505 506 /** 507 * Connects an @attribute to apply values from @column for the 508 * #GtkTreeModel in use. 509 * 510 * Params: 511 * renderer = the #GtkCellRenderer to connect an attribute for 512 * attribute = the attribute name 513 * column = the #GtkTreeModel column to fetch attribute values from 514 * 515 * Since: 3.0 516 */ 517 public void attributeConnect(CellRenderer renderer, string attribute, int column) 518 { 519 gtk_cell_area_attribute_connect(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), Str.toStringz(attribute), column); 520 } 521 522 /** 523 * Disconnects @attribute for the @renderer in @area so that 524 * attribute will no longer be updated with values from the 525 * model. 526 * 527 * Params: 528 * renderer = the #GtkCellRenderer to disconnect an attribute for 529 * attribute = the attribute name 530 * 531 * Since: 3.0 532 */ 533 public void attributeDisconnect(CellRenderer renderer, string attribute) 534 { 535 gtk_cell_area_attribute_disconnect(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), Str.toStringz(attribute)); 536 } 537 538 /** 539 * Returns the model column that an attribute has been mapped to, 540 * or -1 if the attribute is not mapped. 541 * 542 * Params: 543 * renderer = a #GtkCellRenderer 544 * attribute = an attribute on the renderer 545 * 546 * Return: the model column, or -1 547 * 548 * Since: 3.14 549 */ 550 public int attributeGetColumn(CellRenderer renderer, string attribute) 551 { 552 return gtk_cell_area_attribute_get_column(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), Str.toStringz(attribute)); 553 } 554 555 /** 556 * Gets the value of a cell property for @renderer in @area. 557 * 558 * Params: 559 * renderer = a #GtkCellRenderer inside @area 560 * propertyName = the name of the property to get 561 * value = a location to return the value 562 * 563 * Since: 3.0 564 */ 565 public void cellGetProperty(CellRenderer renderer, string propertyName, Value value) 566 { 567 gtk_cell_area_cell_get_property(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), Str.toStringz(propertyName), (value is null) ? null : value.getValueStruct()); 568 } 569 570 /** 571 * Gets the values of one or more cell properties for @renderer in @area. 572 * 573 * Params: 574 * renderer = a #GtkCellRenderer inside @area 575 * firstPropertyName = the name of the first property to get 576 * varArgs = return location for the first property, followed 577 * optionally by more name/return location pairs, followed by %NULL 578 * 579 * Since: 3.0 580 */ 581 public void cellGetValist(CellRenderer renderer, string firstPropertyName, void* varArgs) 582 { 583 gtk_cell_area_cell_get_valist(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), Str.toStringz(firstPropertyName), varArgs); 584 } 585 586 /** 587 * Sets a cell property for @renderer in @area. 588 * 589 * Params: 590 * renderer = a #GtkCellRenderer inside @area 591 * propertyName = the name of the cell property to set 592 * value = the value to set the cell property to 593 * 594 * Since: 3.0 595 */ 596 public void cellSetProperty(CellRenderer renderer, string propertyName, Value value) 597 { 598 gtk_cell_area_cell_set_property(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), Str.toStringz(propertyName), (value is null) ? null : value.getValueStruct()); 599 } 600 601 /** 602 * Sets one or more cell properties for @renderer in @area. 603 * 604 * Params: 605 * renderer = a #GtkCellRenderer which inside @area 606 * firstPropertyName = the name of the first cell property to set 607 * varArgs = a %NULL-terminated list of property names and values, starting 608 * with @first_prop_name 609 * 610 * Since: 3.0 611 */ 612 public void cellSetValist(CellRenderer renderer, string firstPropertyName, void* varArgs) 613 { 614 gtk_cell_area_cell_set_valist(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), Str.toStringz(firstPropertyName), varArgs); 615 } 616 617 /** 618 * This is sometimes needed for cases where rows need to share 619 * alignments in one orientation but may be separately grouped 620 * in the opposing orientation. 621 * 622 * For instance, #GtkIconView creates all icons (rows) to have 623 * the same width and the cells theirin to have the same 624 * horizontal alignments. However each row of icons may have 625 * a separate collective height. #GtkIconView uses this to 626 * request the heights of each row based on a context which 627 * was already used to request all the row widths that are 628 * to be displayed. 629 * 630 * Params: 631 * context = the #GtkCellAreaContext to copy 632 * 633 * Return: a newly created #GtkCellAreaContext copy of @context. 634 * 635 * Since: 3.0 636 */ 637 public CellAreaContext copyContext(CellAreaContext context) 638 { 639 auto p = gtk_cell_area_copy_context(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct()); 640 641 if(p is null) 642 { 643 return null; 644 } 645 646 return ObjectG.getDObject!(CellAreaContext)(cast(GtkCellAreaContext*) p, true); 647 } 648 649 /** 650 * Creates a #GtkCellAreaContext to be used with @area for 651 * all purposes. #GtkCellAreaContext stores geometry information 652 * for rows for which it was operated on, it is important to use 653 * the same context for the same row of data at all times (i.e. 654 * one should render and handle events with the same #GtkCellAreaContext 655 * which was used to request the size of those rows of data). 656 * 657 * Return: a newly created #GtkCellAreaContext which can be used with @area. 658 * 659 * Since: 3.0 660 */ 661 public CellAreaContext createContext() 662 { 663 auto p = gtk_cell_area_create_context(gtkCellArea); 664 665 if(p is null) 666 { 667 return null; 668 } 669 670 return ObjectG.getDObject!(CellAreaContext)(cast(GtkCellAreaContext*) p, true); 671 } 672 673 /** 674 * Delegates event handling to a #GtkCellArea. 675 * 676 * Params: 677 * context = the #GtkCellAreaContext for this row of data. 678 * widget = the #GtkWidget that @area is rendering to 679 * event = the #GdkEvent to handle 680 * cellArea = the @widget relative coordinates for @area 681 * flags = the #GtkCellRendererState for @area in this row. 682 * 683 * Return: %TRUE if the event was handled by @area. 684 * 685 * Since: 3.0 686 */ 687 public int event(CellAreaContext context, Widget widget, Event event, GdkRectangle* cellArea, GtkCellRendererState flags) 688 { 689 return gtk_cell_area_event(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), (event is null) ? null : event.getEventStruct(), cellArea, flags); 690 } 691 692 /** 693 * This should be called by the @area’s owning layout widget 694 * when focus is to be passed to @area, or moved within @area 695 * for a given @direction and row data. 696 * 697 * Implementing #GtkCellArea classes should implement this 698 * method to receive and navigate focus in its own way particular 699 * to how it lays out cells. 700 * 701 * Params: 702 * direction = the #GtkDirectionType 703 * 704 * Return: %TRUE if focus remains inside @area as a result of this call. 705 * 706 * Since: 3.0 707 */ 708 public bool focus(GtkDirectionType direction) 709 { 710 return gtk_cell_area_focus(gtkCellArea, direction) != 0; 711 } 712 713 /** 714 * Calls @callback for every #GtkCellRenderer in @area. 715 * 716 * Params: 717 * callback = the #GtkCellCallback to call 718 * callbackData = user provided data pointer 719 * 720 * Since: 3.0 721 */ 722 public void foreac(GtkCellCallback callback, void* callbackData) 723 { 724 gtk_cell_area_foreach(gtkCellArea, callback, callbackData); 725 } 726 727 /** 728 * Calls @callback for every #GtkCellRenderer in @area with the 729 * allocated rectangle inside @cell_area. 730 * 731 * Params: 732 * context = the #GtkCellAreaContext for this row of data. 733 * widget = the #GtkWidget that @area is rendering to 734 * cellArea = the @widget relative coordinates and size for @area 735 * backgroundArea = the @widget relative coordinates of the background area 736 * callback = the #GtkCellAllocCallback to call 737 * callbackData = user provided data pointer 738 * 739 * Since: 3.0 740 */ 741 public void foreachAlloc(CellAreaContext context, Widget widget, GdkRectangle* cellArea, GdkRectangle* backgroundArea, GtkCellAllocCallback callback, void* callbackData) 742 { 743 gtk_cell_area_foreach_alloc(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), cellArea, backgroundArea, callback, callbackData); 744 } 745 746 /** 747 * Derives the allocation of @renderer inside @area if @area 748 * were to be renderered in @cell_area. 749 * 750 * Params: 751 * context = the #GtkCellAreaContext used to hold sizes for @area. 752 * widget = the #GtkWidget that @area is rendering on 753 * renderer = the #GtkCellRenderer to get the allocation for 754 * cellArea = the whole allocated area for @area in @widget 755 * for this row 756 * allocation = where to store the allocation for @renderer 757 * 758 * Since: 3.0 759 */ 760 public void getCellAllocation(CellAreaContext context, Widget widget, CellRenderer renderer, GdkRectangle* cellArea, out GdkRectangle allocation) 761 { 762 gtk_cell_area_get_cell_allocation(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), (renderer is null) ? null : renderer.getCellRendererStruct(), cellArea, &allocation); 763 } 764 765 /** 766 * Gets the #GtkCellRenderer at @x and @y coordinates inside @area and optionally 767 * returns the full cell allocation for it inside @cell_area. 768 * 769 * Params: 770 * context = the #GtkCellAreaContext used to hold sizes for @area. 771 * widget = the #GtkWidget that @area is rendering on 772 * cellArea = the whole allocated area for @area in @widget 773 * for this row 774 * x = the x position 775 * y = the y position 776 * allocArea = where to store the inner allocated area of the 777 * returned cell renderer, or %NULL. 778 * 779 * Return: the #GtkCellRenderer at @x and @y. 780 * 781 * Since: 3.0 782 */ 783 public CellRenderer getCellAtPosition(CellAreaContext context, Widget widget, GdkRectangle* cellArea, int x, int y, out GdkRectangle allocArea) 784 { 785 auto p = gtk_cell_area_get_cell_at_position(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), cellArea, x, y, &allocArea); 786 787 if(p is null) 788 { 789 return null; 790 } 791 792 return ObjectG.getDObject!(CellRenderer)(cast(GtkCellRenderer*) p); 793 } 794 795 /** 796 * Gets the current #GtkTreePath string for the currently 797 * applied #GtkTreeIter, this is implicitly updated when 798 * gtk_cell_area_apply_attributes() is called and can be 799 * used to interact with renderers from #GtkCellArea 800 * subclasses. 801 * 802 * Return: The current #GtkTreePath string for the current 803 * attributes applied to @area. This string belongs to the area and 804 * should not be freed. 805 * 806 * Since: 3.0 807 */ 808 public string getCurrentPathString() 809 { 810 return Str.toString(gtk_cell_area_get_current_path_string(gtkCellArea)); 811 } 812 813 /** 814 * Gets the #GtkCellEditable widget currently used 815 * to edit the currently edited cell. 816 * 817 * Return: The currently active #GtkCellEditable widget 818 * 819 * Since: 3.0 820 */ 821 public CellEditableIF getEditWidget() 822 { 823 auto p = gtk_cell_area_get_edit_widget(gtkCellArea); 824 825 if(p is null) 826 { 827 return null; 828 } 829 830 return ObjectG.getDObject!(CellEditable, CellEditableIF)(cast(GtkCellEditable*) p); 831 } 832 833 /** 834 * Gets the #GtkCellRenderer in @area that is currently 835 * being edited. 836 * 837 * Return: The currently edited #GtkCellRenderer 838 * 839 * Since: 3.0 840 */ 841 public CellRenderer getEditedCell() 842 { 843 auto p = gtk_cell_area_get_edited_cell(gtkCellArea); 844 845 if(p is null) 846 { 847 return null; 848 } 849 850 return ObjectG.getDObject!(CellRenderer)(cast(GtkCellRenderer*) p); 851 } 852 853 /** 854 * Retrieves the currently focused cell for @area 855 * 856 * Return: the currently focused cell in @area. 857 * 858 * Since: 3.0 859 */ 860 public CellRenderer getFocusCell() 861 { 862 auto p = gtk_cell_area_get_focus_cell(gtkCellArea); 863 864 if(p is null) 865 { 866 return null; 867 } 868 869 return ObjectG.getDObject!(CellRenderer)(cast(GtkCellRenderer*) p); 870 } 871 872 /** 873 * Gets the #GtkCellRenderer which is expected to be focusable 874 * for which @renderer is, or may be a sibling. 875 * 876 * This is handy for #GtkCellArea subclasses when handling events, 877 * after determining the renderer at the event location it can 878 * then chose to activate the focus cell for which the event 879 * cell may have been a sibling. 880 * 881 * Params: 882 * renderer = the #GtkCellRenderer 883 * 884 * Return: the #GtkCellRenderer for which @renderer 885 * is a sibling, or %NULL. 886 * 887 * Since: 3.0 888 */ 889 public CellRenderer getFocusFromSibling(CellRenderer renderer) 890 { 891 auto p = gtk_cell_area_get_focus_from_sibling(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct()); 892 893 if(p is null) 894 { 895 return null; 896 } 897 898 return ObjectG.getDObject!(CellRenderer)(cast(GtkCellRenderer*) p); 899 } 900 901 /** 902 * Gets the focus sibling cell renderers for @renderer. 903 * 904 * Params: 905 * renderer = the #GtkCellRenderer expected to have focus 906 * 907 * Return: A #GList of #GtkCellRenderers. 908 * The returned list is internal and should not be freed. 909 * 910 * Since: 3.0 911 */ 912 public ListG getFocusSiblings(CellRenderer renderer) 913 { 914 auto p = gtk_cell_area_get_focus_siblings(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct()); 915 916 if(p is null) 917 { 918 return null; 919 } 920 921 return new ListG(cast(GList*) p); 922 } 923 924 /** 925 * Retrieves a cell area’s initial minimum and natural height. 926 * 927 * @area will store some geometrical information in @context along the way; 928 * when requesting sizes over an arbitrary number of rows, it’s not important 929 * to check the @minimum_height and @natural_height of this call but rather to 930 * consult gtk_cell_area_context_get_preferred_height() after a series of 931 * requests. 932 * 933 * Params: 934 * context = the #GtkCellAreaContext to perform this request with 935 * widget = the #GtkWidget where @area will be rendering 936 * minimumHeight = location to store the minimum height, or %NULL 937 * naturalHeight = location to store the natural height, or %NULL 938 * 939 * Since: 3.0 940 */ 941 public void getPreferredHeight(CellAreaContext context, Widget widget, out int minimumHeight, out int naturalHeight) 942 { 943 gtk_cell_area_get_preferred_height(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), &minimumHeight, &naturalHeight); 944 } 945 946 /** 947 * Retrieves a cell area’s minimum and natural height if it would be given 948 * the specified @width. 949 * 950 * @area stores some geometrical information in @context along the way 951 * while calling gtk_cell_area_get_preferred_width(). It’s important to 952 * perform a series of gtk_cell_area_get_preferred_width() requests with 953 * @context first and then call gtk_cell_area_get_preferred_height_for_width() 954 * on each cell area individually to get the height for width of each 955 * fully requested row. 956 * 957 * If at some point, the width of a single row changes, it should be 958 * requested with gtk_cell_area_get_preferred_width() again and then 959 * the full width of the requested rows checked again with 960 * gtk_cell_area_context_get_preferred_width(). 961 * 962 * Params: 963 * context = the #GtkCellAreaContext which has already been requested for widths. 964 * widget = the #GtkWidget where @area will be rendering 965 * width = the width for which to check the height of this area 966 * minimumHeight = location to store the minimum height, or %NULL 967 * naturalHeight = location to store the natural height, or %NULL 968 * 969 * Since: 3.0 970 */ 971 public void getPreferredHeightForWidth(CellAreaContext context, Widget widget, int width, out int minimumHeight, out int naturalHeight) 972 { 973 gtk_cell_area_get_preferred_height_for_width(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), width, &minimumHeight, &naturalHeight); 974 } 975 976 /** 977 * Retrieves a cell area’s initial minimum and natural width. 978 * 979 * @area will store some geometrical information in @context along the way; 980 * when requesting sizes over an arbitrary number of rows, it’s not important 981 * to check the @minimum_width and @natural_width of this call but rather to 982 * consult gtk_cell_area_context_get_preferred_width() after a series of 983 * requests. 984 * 985 * Params: 986 * context = the #GtkCellAreaContext to perform this request with 987 * widget = the #GtkWidget where @area will be rendering 988 * minimumWidth = location to store the minimum width, or %NULL 989 * naturalWidth = location to store the natural width, or %NULL 990 * 991 * Since: 3.0 992 */ 993 public void getPreferredWidth(CellAreaContext context, Widget widget, out int minimumWidth, out int naturalWidth) 994 { 995 gtk_cell_area_get_preferred_width(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), &minimumWidth, &naturalWidth); 996 } 997 998 /** 999 * Retrieves a cell area’s minimum and natural width if it would be given 1000 * the specified @height. 1001 * 1002 * @area stores some geometrical information in @context along the way 1003 * while calling gtk_cell_area_get_preferred_height(). It’s important to 1004 * perform a series of gtk_cell_area_get_preferred_height() requests with 1005 * @context first and then call gtk_cell_area_get_preferred_width_for_height() 1006 * on each cell area individually to get the height for width of each 1007 * fully requested row. 1008 * 1009 * If at some point, the height of a single row changes, it should be 1010 * requested with gtk_cell_area_get_preferred_height() again and then 1011 * the full height of the requested rows checked again with 1012 * gtk_cell_area_context_get_preferred_height(). 1013 * 1014 * Params: 1015 * context = the #GtkCellAreaContext which has already been requested for widths. 1016 * widget = the #GtkWidget where @area will be rendering 1017 * height = the height for which to check the width of this area 1018 * minimumWidth = location to store the minimum width, or %NULL 1019 * naturalWidth = location to store the natural width, or %NULL 1020 * 1021 * Since: 3.0 1022 */ 1023 public void getPreferredWidthForHeight(CellAreaContext context, Widget widget, int height, out int minimumWidth, out int naturalWidth) 1024 { 1025 gtk_cell_area_get_preferred_width_for_height(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), height, &minimumWidth, &naturalWidth); 1026 } 1027 1028 /** 1029 * Gets whether the area prefers a height-for-width layout 1030 * or a width-for-height layout. 1031 * 1032 * Return: The #GtkSizeRequestMode preferred by @area. 1033 * 1034 * Since: 3.0 1035 */ 1036 public GtkSizeRequestMode getRequestMode() 1037 { 1038 return gtk_cell_area_get_request_mode(gtkCellArea); 1039 } 1040 1041 /** 1042 * Checks if @area contains @renderer. 1043 * 1044 * Params: 1045 * renderer = the #GtkCellRenderer to check 1046 * 1047 * Return: %TRUE if @renderer is in the @area. 1048 * 1049 * Since: 3.0 1050 */ 1051 public bool hasRenderer(CellRenderer renderer) 1052 { 1053 return gtk_cell_area_has_renderer(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct()) != 0; 1054 } 1055 1056 /** 1057 * This is a convenience function for #GtkCellArea implementations 1058 * to get the inner area where a given #GtkCellRenderer will be 1059 * rendered. It removes any padding previously added by gtk_cell_area_request_renderer(). 1060 * 1061 * Params: 1062 * widget = the #GtkWidget that @area is rendering onto 1063 * cellArea = the @widget relative coordinates where one of @area’s cells 1064 * is to be placed 1065 * innerArea = the return location for the inner cell area 1066 * 1067 * Since: 3.0 1068 */ 1069 public void innerCellArea(Widget widget, GdkRectangle* cellArea, out GdkRectangle innerArea) 1070 { 1071 gtk_cell_area_inner_cell_area(gtkCellArea, (widget is null) ? null : widget.getWidgetStruct(), cellArea, &innerArea); 1072 } 1073 1074 /** 1075 * Returns whether the area can do anything when activated, 1076 * after applying new attributes to @area. 1077 * 1078 * Return: whether @area can do anything when activated. 1079 * 1080 * Since: 3.0 1081 */ 1082 public bool isActivatable() 1083 { 1084 return gtk_cell_area_is_activatable(gtkCellArea) != 0; 1085 } 1086 1087 /** 1088 * Returns whether @sibling is one of @renderer’s focus siblings 1089 * (see gtk_cell_area_add_focus_sibling()). 1090 * 1091 * Params: 1092 * renderer = the #GtkCellRenderer expected to have focus 1093 * sibling = the #GtkCellRenderer to check against @renderer’s sibling list 1094 * 1095 * Return: %TRUE if @sibling is a focus sibling of @renderer 1096 * 1097 * Since: 3.0 1098 */ 1099 public bool isFocusSibling(CellRenderer renderer, CellRenderer sibling) 1100 { 1101 return gtk_cell_area_is_focus_sibling(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), (sibling is null) ? null : sibling.getCellRendererStruct()) != 0; 1102 } 1103 1104 /** 1105 * Removes @renderer from @area. 1106 * 1107 * Params: 1108 * renderer = the #GtkCellRenderer to remove from @area 1109 * 1110 * Since: 3.0 1111 */ 1112 public void remove(CellRenderer renderer) 1113 { 1114 gtk_cell_area_remove(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct()); 1115 } 1116 1117 /** 1118 * Removes @sibling from @renderer’s focus sibling list 1119 * (see gtk_cell_area_add_focus_sibling()). 1120 * 1121 * Params: 1122 * renderer = the #GtkCellRenderer expected to have focus 1123 * sibling = the #GtkCellRenderer to remove from @renderer’s focus area 1124 * 1125 * Since: 3.0 1126 */ 1127 public void removeFocusSibling(CellRenderer renderer, CellRenderer sibling) 1128 { 1129 gtk_cell_area_remove_focus_sibling(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), (sibling is null) ? null : sibling.getCellRendererStruct()); 1130 } 1131 1132 /** 1133 * Renders @area’s cells according to @area’s layout onto @widget at 1134 * the given coordinates. 1135 * 1136 * Params: 1137 * context = the #GtkCellAreaContext for this row of data. 1138 * widget = the #GtkWidget that @area is rendering to 1139 * cr = the #cairo_t to render with 1140 * backgroundArea = the @widget relative coordinates for @area’s background 1141 * cellArea = the @widget relative coordinates for @area 1142 * flags = the #GtkCellRendererState for @area in this row. 1143 * paintFocus = whether @area should paint focus on focused cells for focused rows or not. 1144 * 1145 * Since: 3.0 1146 */ 1147 public void render(CellAreaContext context, Widget widget, Context cr, GdkRectangle* backgroundArea, GdkRectangle* cellArea, GtkCellRendererState flags, bool paintFocus) 1148 { 1149 gtk_cell_area_render(gtkCellArea, (context is null) ? null : context.getCellAreaContextStruct(), (widget is null) ? null : widget.getWidgetStruct(), (cr is null) ? null : cr.getContextStruct(), backgroundArea, cellArea, flags, paintFocus); 1150 } 1151 1152 /** 1153 * This is a convenience function for #GtkCellArea implementations 1154 * to request size for cell renderers. It’s important to use this 1155 * function to request size and then use gtk_cell_area_inner_cell_area() 1156 * at render and event time since this function will add padding 1157 * around the cell for focus painting. 1158 * 1159 * Params: 1160 * renderer = the #GtkCellRenderer to request size for 1161 * orientation = the #GtkOrientation in which to request size 1162 * widget = the #GtkWidget that @area is rendering onto 1163 * forSize = the allocation contextual size to request for, or -1 if 1164 * the base request for the orientation is to be returned. 1165 * minimumSize = location to store the minimum size, or %NULL 1166 * naturalSize = location to store the natural size, or %NULL 1167 * 1168 * Since: 3.0 1169 */ 1170 public void requestRenderer(CellRenderer renderer, GtkOrientation orientation, Widget widget, int forSize, out int minimumSize, out int naturalSize) 1171 { 1172 gtk_cell_area_request_renderer(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct(), orientation, (widget is null) ? null : widget.getWidgetStruct(), forSize, &minimumSize, &naturalSize); 1173 } 1174 1175 /** 1176 * Explicitly sets the currently focused cell to @renderer. 1177 * 1178 * This is generally called by implementations of 1179 * #GtkCellAreaClass.focus() or #GtkCellAreaClass.event(), 1180 * however it can also be used to implement functions such 1181 * as gtk_tree_view_set_cursor_on_cell(). 1182 * 1183 * Params: 1184 * renderer = the #GtkCellRenderer to give focus to 1185 * 1186 * Since: 3.0 1187 */ 1188 public void setFocusCell(CellRenderer renderer) 1189 { 1190 gtk_cell_area_set_focus_cell(gtkCellArea, (renderer is null) ? null : renderer.getCellRendererStruct()); 1191 } 1192 1193 /** 1194 * Explicitly stops the editing of the currently edited cell. 1195 * 1196 * If @canceled is %TRUE, the currently edited cell renderer 1197 * will emit the ::editing-canceled signal, otherwise the 1198 * the ::editing-done signal will be emitted on the current 1199 * edit widget. 1200 * 1201 * See gtk_cell_area_get_edited_cell() and gtk_cell_area_get_edit_widget(). 1202 * 1203 * Params: 1204 * canceled = whether editing was canceled. 1205 * 1206 * Since: 3.0 1207 */ 1208 public void stopEditing(bool canceled) 1209 { 1210 gtk_cell_area_stop_editing(gtkCellArea, canceled); 1211 } 1212 1213 int[string] connectedSignals; 1214 1215 void delegate(CellRenderer, CellEditableIF, GdkRectangle*, string, CellArea)[] onAddEditableListeners; 1216 /** 1217 * Indicates that editing has started on @renderer and that @editable 1218 * should be added to the owning cell-layouting widget at @cell_area. 1219 * 1220 * Params: 1221 * renderer = the #GtkCellRenderer that started the edited 1222 * editable = the #GtkCellEditable widget to add 1223 * cellArea = the #GtkWidget relative #GdkRectangle coordinates 1224 * where @editable should be added 1225 * path = the #GtkTreePath string this edit was initiated for 1226 * 1227 * Since: 3.0 1228 */ 1229 void addOnAddEditable(void delegate(CellRenderer, CellEditableIF, GdkRectangle*, string, CellArea) dlg, ConnectFlags connectFlags=cast(ConnectFlags)0) 1230 { 1231 if ( "add-editable" !in connectedSignals ) 1232 { 1233 Signals.connectData( 1234 this, 1235 "add-editable", 1236 cast(GCallback)&callBackAddEditable, 1237 cast(void*)this, 1238 null, 1239 connectFlags); 1240 connectedSignals["add-editable"] = 1; 1241 } 1242 onAddEditableListeners ~= dlg; 1243 } 1244 extern(C) static void callBackAddEditable(GtkCellArea* cellareaStruct, GtkCellRenderer* renderer, GtkCellEditable* editable, GdkRectangle* cellArea, char* path, CellArea _cellarea) 1245 { 1246 foreach ( void delegate(CellRenderer, CellEditableIF, GdkRectangle*, string, CellArea) dlg; _cellarea.onAddEditableListeners ) 1247 { 1248 dlg(ObjectG.getDObject!(CellRenderer)(renderer), ObjectG.getDObject!(CellEditable, CellEditableIF)(editable), cellArea, Str.toString(path), _cellarea); 1249 } 1250 } 1251 1252 void delegate(TreeModelIF, TreeIter, bool, bool, CellArea)[] onApplyAttributesListeners; 1253 /** 1254 * This signal is emitted whenever applying attributes to @area from @model 1255 * 1256 * Params: 1257 * model = the #GtkTreeModel to apply the attributes from 1258 * iter = the #GtkTreeIter indicating which row to apply the attributes of 1259 * isExpander = whether the view shows children for this row 1260 * isExpanded = whether the view is currently showing the children of this row 1261 * 1262 * Since: 3.0 1263 */ 1264 void addOnApplyAttributes(void delegate(TreeModelIF, TreeIter, bool, bool, CellArea) dlg, ConnectFlags connectFlags=cast(ConnectFlags)0) 1265 { 1266 if ( "apply-attributes" !in connectedSignals ) 1267 { 1268 Signals.connectData( 1269 this, 1270 "apply-attributes", 1271 cast(GCallback)&callBackApplyAttributes, 1272 cast(void*)this, 1273 null, 1274 connectFlags); 1275 connectedSignals["apply-attributes"] = 1; 1276 } 1277 onApplyAttributesListeners ~= dlg; 1278 } 1279 extern(C) static void callBackApplyAttributes(GtkCellArea* cellareaStruct, GtkTreeModel* model, GtkTreeIter* iter, bool isExpander, bool isExpanded, CellArea _cellarea) 1280 { 1281 foreach ( void delegate(TreeModelIF, TreeIter, bool, bool, CellArea) dlg; _cellarea.onApplyAttributesListeners ) 1282 { 1283 dlg(ObjectG.getDObject!(TreeModel, TreeModelIF)(model), ObjectG.getDObject!(TreeIter)(iter), isExpander, isExpanded, _cellarea); 1284 } 1285 } 1286 1287 void delegate(CellRenderer, string, CellArea)[] onFocusChangedListeners; 1288 /** 1289 * Indicates that focus changed on this @area. This signal 1290 * is emitted either as a result of focus handling or event 1291 * handling. 1292 * 1293 * It's possible that the signal is emitted even if the 1294 * currently focused renderer did not change, this is 1295 * because focus may change to the same renderer in the 1296 * same cell area for a different row of data. 1297 * 1298 * Params: 1299 * renderer = the #GtkCellRenderer that has focus 1300 * path = the current #GtkTreePath string set for @area 1301 * 1302 * Since: 3.0 1303 */ 1304 void addOnFocusChanged(void delegate(CellRenderer, string, CellArea) dlg, ConnectFlags connectFlags=cast(ConnectFlags)0) 1305 { 1306 if ( "focus-changed" !in connectedSignals ) 1307 { 1308 Signals.connectData( 1309 this, 1310 "focus-changed", 1311 cast(GCallback)&callBackFocusChanged, 1312 cast(void*)this, 1313 null, 1314 connectFlags); 1315 connectedSignals["focus-changed"] = 1; 1316 } 1317 onFocusChangedListeners ~= dlg; 1318 } 1319 extern(C) static void callBackFocusChanged(GtkCellArea* cellareaStruct, GtkCellRenderer* renderer, char* path, CellArea _cellarea) 1320 { 1321 foreach ( void delegate(CellRenderer, string, CellArea) dlg; _cellarea.onFocusChangedListeners ) 1322 { 1323 dlg(ObjectG.getDObject!(CellRenderer)(renderer), Str.toString(path), _cellarea); 1324 } 1325 } 1326 1327 void delegate(CellRenderer, CellEditableIF, CellArea)[] onRemoveEditableListeners; 1328 /** 1329 * Indicates that editing finished on @renderer and that @editable 1330 * should be removed from the owning cell-layouting widget. 1331 * 1332 * Params: 1333 * renderer = the #GtkCellRenderer that finished editeding 1334 * editable = the #GtkCellEditable widget to remove 1335 * 1336 * Since: 3.0 1337 */ 1338 void addOnRemoveEditable(void delegate(CellRenderer, CellEditableIF, CellArea) dlg, ConnectFlags connectFlags=cast(ConnectFlags)0) 1339 { 1340 if ( "remove-editable" !in connectedSignals ) 1341 { 1342 Signals.connectData( 1343 this, 1344 "remove-editable", 1345 cast(GCallback)&callBackRemoveEditable, 1346 cast(void*)this, 1347 null, 1348 connectFlags); 1349 connectedSignals["remove-editable"] = 1; 1350 } 1351 onRemoveEditableListeners ~= dlg; 1352 } 1353 extern(C) static void callBackRemoveEditable(GtkCellArea* cellareaStruct, GtkCellRenderer* renderer, GtkCellEditable* editable, CellArea _cellarea) 1354 { 1355 foreach ( void delegate(CellRenderer, CellEditableIF, CellArea) dlg; _cellarea.onRemoveEditableListeners ) 1356 { 1357 dlg(ObjectG.getDObject!(CellRenderer)(renderer), ObjectG.getDObject!(CellEditable, CellEditableIF)(editable), _cellarea); 1358 } 1359 } 1360 }