Some eolian properties have setters that return a value (an arguable decision, but legal as of now).
This should prevent a C# property from being created, since the return value would then be lost.
To be clear, only the Set and Get C# method should be generated.
As discussed in Z150, we will skip these setters only for really complex types like Futures, etc.
In the discussion in Z150, it was raised the issue that property accessors are desired/required for better integration with XAML-style property binding.
One alternative to removing setters returning values would be wrapping the return value (usually an indicator of success/failure) in a check raising an exception if it failed. This could work for booleans and Eina_Errors but may be overkill if the failure is a "soft" one and could be ignored. I'm not sure on how the exceptions would play with XAML-bindings too.
That said, here is a list of setters with returning values, longside their documentation.
| class | property | type | stable? | return doc |
|---|---|---|---|---|
| Efl.Access.Action | action_description | Eina_Bool | False | $true if description was set, $false otherwise |
| Efl.Access.Component | extents | Eina_Bool | False | $true if geometry was set, $false otherwise |
| Efl.Access.Component | screen_position | Eina_Bool | False | $true if position was set, $false otherwise |
| Efl.Access.Editable.Text | text_content | Eina_Bool | False | $true if setting the value succeeded, $false otherwise |
| Efl.Access.Text | access_selection | Eina_Bool | False | $true if selection was set, $false otherwise |
| Efl.Access.Text | caret_offset | Eina_Bool | False | $true if caret was successfully moved, $false otherwise. |
| Efl.Access.Value | value_and_text | Eina_Bool | False | $true if setting widgets value has succeeded, otherwise $false . |
| Efl.Canvas.Object | pointer_mode | Eina_Bool | False | $true if pointer behaviour was set, $false otherwise |
| Efl.Canvas.Object | pointer_mode_by_device | Eina_Bool | False | $true if pointer mode was set, $false otherwise |
| Efl.Input.Pointer | value | Eina_Bool | False | $false if the value could not be set. |
| Efl.Ui.Widget | cursor | Eina_Bool | False | $true if successful. |
| Efl.Ui.Widget | cursor_style | Eina_Bool | False | $true if successful. |
| Efl.Ui.Widget | cursor_theme_search_enabled | Eina_Bool | False | $true if successful. |
| Ecore.Audio | format | Eina_Bool | True | $true if the format was supported, $false otherwise |
| Ecore.Audio | source | Eina_Bool | True | $true if the source was set correctly (i.e. the file was opened), $false otherwise |
| Efl.Canvas.Proxy | source | Eina_Bool | True | Returns $true in case of success. |
| Efl.Canvas.Surface | native_buffer | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Canvas.Surface_X11 | pixmap | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Canvas.Video | engine | Eina_Bool | True | $true if the specified module was successfully initialized for this object, $false otherwise. |
| Efl.Config | config | Eina_Bool | True | $false in case of error: value type was invalid, the config can't be changed, config does not exist... |
| Efl.Content | content | Eina_Bool | True | $true if $content was successfully swallowed. |
| Efl.Core.Command_Line | command_array | Eina_Bool | True | On success $true, $false otherwise |
| Efl.Core.Command_Line | command_string | Eina_Bool | True | On success $true, $false otherwise |
| Efl.Gfx.Color_Class | color_class | Eina_Bool | True | $true if setting the color succeeded, $false otherwise |
| Efl.Gfx.Color_Class | color_class_code | Eina_Bool | True | $true if setting the color succeeded, $false otherwise |
| Efl.Gfx.Frame_Controller | frame | Eina_Bool | True | Returns $true if the frame index is valid. |
| Efl.Gfx.Size_Class | size_class | Eina_Bool | True | $true, on success or $false, on error |
| Efl.Gfx.Text_Class | text_class | Eina_Bool | True | $true, on success or $false, on error |
| Efl.Io.Buffer | position_read | Eina_Bool | True | $true if setting the position succeeded, $false otherwise |
| Efl.Io.Buffer | position_write | Eina_Bool | True | $true if setting the position succeeded, $false otherwise |
| Efl.Io.Closer | close_on_exec | Eina_Bool | True | $true if could set, $false if not supported or failed. |
| Efl.Io.Positioner | position | Eina_Bool | True | $true if could reposition, $false if errors. |
| Efl.Io.Sizer | size | Eina_Bool | True | $true if could resize, $false if errors. |
| Efl.Net.Dialer_Ssl | keep_alive | Eina_Bool | True | $true on success |
| Efl.Net.Dialer_Ssl | no_delay | Eina_Bool | True | $true on success |
| Efl.Net.Server_Fd | close_on_exec | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Net.Server_Fd | reuse_address | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Net.Server_Fd | reuse_port | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Net.Server_Udp | dont_route | Eina_Bool | True | $true on success |
| Efl.Net.Socket_Tcp | cork | Eina_Bool | True | $true on success |
| Efl.Net.Socket_Tcp | keep_alive | Eina_Bool | True | $true on success |
| Efl.Net.Socket_Tcp | no_delay | Eina_Bool | True | $true on success |
| Efl.Net.Socket_Udp | cork | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Net.Socket_Udp | dont_route | Eina_Bool | True | $true on success |
| Efl.Net.Socket_Udp | reuse_address | Eina_Bool | True | $true on success |
| Efl.Net.Socket_Udp | reuse_port | Eina_Bool | True | $true on success |
| Efl.Player | paused | Eina_Bool | True | If $true, the property change has succeeded. |
| Efl.Player | playing | Eina_Bool | True | If $true, the property change has succeeded. |
| Efl.Text_Annotate | annotation | Eina_Bool | True | $true on success, $false otherwise. |
| Efl.Ui.Animation_View | speed | Eina_Bool | True | $true when it's successful. $false otherwise. |
| Efl.Ui.Calendar | date | Eina_Bool | True | $true on success. |
| Efl.Ui.Calendar | date_max | Eina_Bool | True | $true on success. |
| Efl.Ui.Calendar | date_min | Eina_Bool | True | $true on success. |
| Efl.Ui.Drag | drag_page | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Ui.Drag | drag_size | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Ui.Drag | drag_step | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Ui.Drag | drag_value | Eina_Bool | True | $true on success, $false otherwise |
| Efl.Ui.Focus.Manager | root | Eina_Bool | True | $true on success, $false if it had already been set. |
| Efl.Ui.Image | icon | Eina_Bool | True | $true on success, $false on error |
| Efl.Ui.Widget_Scrollable_Content | scrollable_content | Eina_Bool | True | $true on success. |
| Efl.Ui.Win | focus_highlight_style | Eina_Bool | True | $true on success, $false otherwise. |
| Efl.File | file | Eina_Error | True | 0 on success, error code otherwise |
| Efl.File | mmap | Eina_Error | True | 0 on success, error code otherwise |
| Efl.Gfx.Image | stretch_region | Eina_Error | True | Return an error code if the provided values are incorrect. |
| Efl.Net.Server_Udp | multicast_loopback | Eina_Error | True | 0 on success, error code otherwise |
| Efl.Net.Server_Udp | multicast_time_to_live | Eina_Error | True | 0 on success, error code otherwise |
| Efl.Net.Socket_Udp | bind | Eina_Error | True | $0 on success, error code otherwise |
| Efl.Net.Socket_Udp | multicast_loopback | Eina_Error | True | $0 on success, error code otherwise |
| Efl.Net.Socket_Udp | multicast_time_to_live | Eina_Error | True | $0 on success, error code otherwise |
| Efl.Ui.Layout_Base | theme | Eina_Error | True | Whether the theme was successfully applied or not, see the Efl.Ui.Theme.Apply_Error subset of @Eina.Error for more information. |
| Efl.Ui.Widget | style | Eina_Error | True | Whether the style was successfully applied or not, see the Efl.Ui.Theme.Apply_Error subset of @Eina.Error for more information. |
| Efl.Io.Manager | xattr | Eina_Future * | True | Future for asynchronous set operation |
| Efl.Model | property | Eina_Future * | True | Return an error in case the property could not be set, or the value that was set otherwise. |