summaryrefslogtreecommitdiff
path: root/src/lib/elementary/elm_widget.eo
diff options
context:
space:
mode:
authorJean-Philippe Andre <jp.andre@samsung.com>2017-08-31 16:10:43 +0900
committerJean-Philippe Andre <jp.andre@samsung.com>2017-09-01 10:09:37 +0900
commit4e81df7cb2ee558cf5a9137835e46dbaa0dce35d (patch)
tree02fd190964c324d151e023895eba6f991746f78e /src/lib/elementary/elm_widget.eo
parentb40d8296ffe5d216c4a3458b8b6acdf5b35a4f55 (diff)
widget: Forward focus_highlight_style to win
See the previous commits. All focus_highlight APIs are defined in the Widget class but only implemented at the Window level. For consistency I believe this call should also be forwarded to the window. The previous logic had absolutely no effect at all, except storing a stringshare. The day focus_highlight becomes widget-specific (i.e. each widget has its own highlight style) then this can be changed. Note: This will apply to legacy API as well. Ref T5363
Diffstat (limited to 'src/lib/elementary/elm_widget.eo')
-rw-r--r--src/lib/elementary/elm_widget.eo64
1 files changed, 46 insertions, 18 deletions
diff --git a/src/lib/elementary/elm_widget.eo b/src/lib/elementary/elm_widget.eo
index 08cbd8f87c..ebeea3dc14 100644
--- a/src/lib/elementary/elm_widget.eo
+++ b/src/lib/elementary/elm_widget.eo
@@ -516,45 +516,73 @@ abstract Elm.Widget (Efl.Canvas.Group, Elm.Interface.Atspi_Accessible,
516 region: Eina.Rectangle; [[The rectangle area.]] 516 region: Eina.Rectangle; [[The rectangle area.]]
517 } 517 }
518 } 518 }
519 @property focus_highlight_style { 519 @property focus_highlight_enabled {
520 [[Control the widget focus highlight style. 520 [[Whether focus highlight is enabled or not.
521 521
522 If $style is $null, the default will be used. 522 As of EFL 1.21 focus highlight properties apply to a single window,
523 not a single widget. As a consequence, calls to this function may
524 be forwarded to the parent window. Future versions of EFL may
525 implement widget-specific focus highlight properties.
526
527 See also @.widget_top.
528 See also @.focus_highlight_style.
529 See also @.focus_highlight_animate.
523 ]] 530 ]]
524 set { 531 set {
525 return: bool; [[$true on success, $false otherwise.]] 532 [[Set the enabled status for the focus highlight in a window.
533
534 This function will enable or disable the focus highlight,
535 regardless of the global setting for it.
536 ]]
526 } 537 }
527 get { 538 get {
539 [[Get the enabled value of the focus highlight for this window.]]
528 } 540 }
529 values { 541 values {
530 style: string @nullable; [[The name of the focus highlight style.]] 542 enabled: bool; [[The enabled value for the highlight.]]
531 } 543 }
532 } 544 }
533 @property focus_highlight_enabled { 545 @property focus_highlight_style {
534 [[Whether focus highlight is enabled or not.]] 546 [[Control the widget focus highlight style.
535 set {
536 [[Set the enabled status for the focus highlight in a window.
537 547
538 This function will enable or disable the focus highlight only 548 If $style is $null, the default will be used.
539 for the given window, regardless of the global setting for it. 549
540 ]] 550 As of EFL 1.21 focus highlight properties apply to a single window,
551 not a single widget. As a consequence, calls to this function may
552 be forwarded to the parent window. Future versions of EFL may
553 implement widget-specific focus highlight properties.
554
555 See also @.widget_top.
556 See also @.focus_highlight_enabled.
557 See also @.focus_highlight_animate.
558 ]]
559 set {
560 /* FIXME: This is async... success here means nothing. */
561 return: bool; [[$true on success, $false otherwise.]]
541 } 562 }
542 get { 563 get {
543 [[Get the enabled value of the focus highlight for this window.]]
544 } 564 }
545 values { 565 values {
546 enabled: bool; [[The enabled value for the highlight.]] 566 style: string @nullable; [[The name of the focus highlight style.]]
547 } 567 }
548 } 568 }
549 @property focus_highlight_animate { 569 @property focus_highlight_animate {
550 [[Whether focus highlight should animate or not.]] 570 [[Whether focus highlight should animate or not.
571
572 As of EFL 1.21 focus highlight properties apply to a single window,
573 not a single widget. As a consequence, calls to this function may
574 be forwarded to the parent window. Future versions of EFL may
575 implement widget-specific focus highlight properties.
576
577 See also @.widget_top.
578 See also @.focus_highlight_style.
579 See also @.focus_highlight_enabled.
580 ]]
551 set { 581 set {
552 [[Set the animate status for the focus highlight for this window. 582 [[Set the animate status for the focus highlight for this window.
553 583
554 This function will enable or disable the animation of focus 584 This function will enable or disable the animation of focus
555 highlight only for the given window. If the widget is not a 585 highlight.
556 window, then this call is forwarded to the window (using
557 @.widget_top).
558 ]] 586 ]]
559 } 587 }
560 get { 588 get {