summaryrefslogtreecommitdiff
path: root/ElmSharp/ElmSharp/Button.cs
blob: e36905470bb14437c8f5f81e399eb635bd016396 (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
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
/*
 * Copyright (c) 2016 Samsung Electronics Co., Ltd All Rights Reserved
 *
 * Licensed under the Apache License, Version 2.0 (the License);
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an AS IS BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

using System;

namespace ElmSharp
{
    /// <summary>
    /// The Button is a widget works as a clickable input element to trigger events.
    /// </summary>
    public class Button : Layout
    {
        private SmartEvent _clicked;
        private SmartEvent _repeated;
        private SmartEvent _pressed;
        private SmartEvent _released;

        /// <summary>
        /// Creates and initializes a new instance of the Button class.
        /// </summary>
        /// <param name="parent">
        /// The EvasObject to which the new Button will be attached as a child.
        /// </param>
        public Button(EvasObject parent) : base(parent)
        {
            _clicked = new SmartEvent(this, this.RealHandle, "clicked");
            _repeated = new SmartEvent(this, this.RealHandle, "repeated");
            _pressed = new SmartEvent(this, this.RealHandle, "pressed");
            _released = new SmartEvent(this, this.RealHandle, "unpressed");

            _clicked.On += (sender, e) =>
            {
                Clicked?.Invoke(this, EventArgs.Empty);
            };

            _repeated.On += (sender, e) =>
            {
                Repeated?.Invoke(this, EventArgs.Empty);
            };

            _pressed.On += (sender, e) =>
            {
                Pressed?.Invoke(this, EventArgs.Empty);
            };

            _released.On += (sender, e) =>
            {
                Released?.Invoke(this, EventArgs.Empty);
            };
        }

        /// <summary>
        /// Clicked will be triggered when Button is clicked.
        /// </summary>
        public event EventHandler Clicked;

        /// <summary>
        /// Repeated will be triggered when Button is pressed without releasing it.
        /// </summary>
        public event EventHandler Repeated;

        /// <summary>
        /// Pressed will be triggered when the Button is pressed.
        /// </summary>
        public event EventHandler Pressed;

        /// <summary>
        /// Released will be triggered when the Button is released after being pressed.
        /// </summary>
        public event EventHandler Released;

        /// <summary>
        /// Sets or gets the autorepeat feature of a given Button.
        /// </summary>
        /// <remarks>
        /// Autorepeat feature means autorepeat event generated when the button is kept pressed.
        /// When set AutoRepeat to false, no autorepeat is performed and buttons will trigger Clicked event when they are clicked.
        /// When set to true, keeping a button pressed continuously trigger Repeated event until the button is released.
        /// The time it takes until it starts triggering Repeated is given by AutoRepeatInitialTime,
        /// and the time between each new emission is given by AutoRepeatGapTimeout.
        /// </remarks>
        public bool AutoRepeat
        {
            get
            {
                return !Interop.Elementary.elm_button_autorepeat_get(RealHandle);
            }
            set
            {
                Interop.Elementary.elm_button_autorepeat_set(RealHandle, value);
            }
        }

        /// <summary>
        /// Sets or gets the initial timeout before the Repeat event is generated.
        /// </summary>
        public double AutoRepeatInitialTime
        {
            get
            {
                return Interop.Elementary.elm_button_autorepeat_initial_timeout_get(RealHandle);
            }
            set
            {
                Interop.Elementary.elm_button_autorepeat_initial_timeout_set(RealHandle, value);
            }
        }

        /// <summary>
        /// Sets or gets the interval between each generated Repeat event.
        /// </summary>
        public double AutoRepeatGapTimeout
        {
            get
            {
                return Interop.Elementary.elm_button_autorepeat_gap_timeout_get(RealHandle);
            }
            set
            {
                Interop.Elementary.elm_button_autorepeat_gap_timeout_set(RealHandle, value);
            }
        }

        [Obsolete("DeleteColorClass is obsolete, please use EdjeObject.DeleteColorClass(string)")]
        public void DeleteColorClass(string part)
        {
            Interop.Elementary.edje_object_color_class_del(Handle, part);
        }

        /// <summary>
        /// Sets or gets the BackgroundColor of a given Button in normal and pressed status.
        /// </summary>
        public override Color BackgroundColor
        {
            set
            {
                if (value.IsDefault)
                {
                    EdjeObject.DeleteColorClass("button/bg");
                    EdjeObject.DeleteColorClass("button/bg_pressed");
                }
                else
                {
                    SetPartColor("bg", value);
                    SetPartColor("bg_pressed", value);
                }
                _backgroundColor = value;
            }
        }

        protected override IntPtr CreateHandle(EvasObject parent)
        {
            IntPtr handle = Interop.Elementary.elm_layout_add(parent.Handle);
            Interop.Elementary.elm_layout_theme_set(handle, "layout", "elm_widget", "default");

            RealHandle = Interop.Elementary.elm_button_add(handle);
            Interop.Elementary.elm_object_part_content_set(handle, "elm.swallow.content", RealHandle);

            return handle;
        }
    }
}