summaryrefslogtreecommitdiff
path: root/src/lib/elementary/efl_ui_single_selectable.eo
blob: 1044082cc616d98023c559817d63b5b4dfd609de (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
interface Efl.Ui.Single_Selectable {
   [[Interface for getting access to a single selected item in the implementor.

     The implementor is free to allow a specific number of selectables being selected or not.
     This interface just covers always the latest selected selectable.

     @since 1.23
   ]]
   c_prefix: efl_ui_selectable;
   methods {
      @property last_selected {
        [[The selectable that was selected most recently.]]
        get {

        }
        values {
          selectable : Efl.Ui.Selectable; [[The latest selected item.]]
        }
      }
      @property fallback_selection {
         [[A object that will be selected in case nothing is selected

           A object set to this property will be selected instead of no item being selected.
           Which means, there will be always at least one element selected.
           If this property is $NULL, the state of "no item is selected" can be reached.

           Setting this property as a result of selection events results in undefined behavior.
         ]]
         values {
            fallback : Efl.Ui.Selectable;
         }
      }
   }
   events {
      selection_changed : void; [[Emitted when there is a change in the selection state. This event will collect all
                                  the item selection change events that are happening within one loop iteration.
                                  This means, you will only get this event once, even if a lot of items have changed.
                                  If you are interested in detailed changes, subscribe to the individual
                                  @[Efl.Ui.Selectable.selected,changed] events of each item.]]
   }
}