feat(gui): add TextEdit_BindProperty()

Author: lc-soft

include/LCUI/gui/widget_base.h

@@ -461,6 +461,11 @@ LCUI_API int Widget_SetRules(LCUI_Widget w, const LCUI_WidgetRulesRec *rules);
 /** Set widget content text */
 LCUI_API void Widget_SetText(LCUI_Widget w, const char *text);
 
+/* Bind an object to a widget property, and the widget property is automatically
+ * updated when the value of the object changes */
+LCUI_API void Widget_BindProperty(LCUI_Widget w, const char *name,
+				  LCUI_Object value);
+
 /** 计算部件的最大宽度 */
 LCUI_API float Widget_ComputeMaxWidth(LCUI_Widget w);
 

src/gui/widget/textedit.c

@@ -64,18 +64,19 @@ typedef struct LCUI_TextEditRec_ {
 	LCUI_TextLayer layer_mask;        /**< 屏蔽后的文本层 */
 	LCUI_TextLayer layer_placeholder; /**< 占位符的文本层 */
 	LCUI_TextLayer layer;             /**< 当前使用的文本层 */
-	LCUI_Widget scrollbars[2];        /**< 两个滚动条 */
-	LCUI_Widget caret;                /**< 文本插入符 */
-	LCUI_BOOL is_read_only;           /**< 是否只读 */
-	LCUI_BOOL is_multiline_mode;      /**< 是否为多行模式 */
-	LCUI_BOOL is_placeholder_shown;   /**< 是否已经显示占位符 */
-	wchar_t *allow_input_char;        /**< 允许输入的字符 */
-	wchar_t password_char;            /**< 屏蔽符的副本 */
-	size_t text_block_size;           /**< 块大小 */
-	LinkedList text_blocks;           /**< 文本块缓冲区 */
-	LinkedList text_tags;             /**< 当前处理的标签列表 */
-	LCUI_BOOL tasks[TASK_TOTAL];      /**< 待处理的任务 */
-	LCUI_Mutex mutex;                 /**< 互斥锁 */
+	LCUI_ObjectWatcher value_watcher;
+	LCUI_Widget scrollbars[2];      /**< 两个滚动条 */
+	LCUI_Widget caret;              /**< 文本插入符 */
+	LCUI_BOOL is_read_only;         /**< 是否只读 */
+	LCUI_BOOL is_multiline_mode;    /**< 是否为多行模式 */
+	LCUI_BOOL is_placeholder_shown; /**< 是否已经显示占位符 */
+	wchar_t *allow_input_char;      /**< 允许输入的字符 */
+	wchar_t password_char;          /**< 屏蔽符的副本 */
+	size_t text_block_size;         /**< 块大小 */
+	LinkedList text_blocks;         /**< 文本块缓冲区 */
+	LinkedList text_tags;           /**< 当前处理的标签列表 */
+	LCUI_BOOL tasks[TASK_TOTAL];    /**< 待处理的任务 */
+	LCUI_Mutex mutex;               /**< 互斥锁 */
 } LCUI_TextEditRec, *LCUI_TextEdit;
 
 typedef enum {
@@ -886,6 +887,7 @@ static void TextEdit_OnInit(LCUI_Widget w)
 	edit->layer_source = TextLayer_New();
 	edit->layer_placeholder = TextLayer_New();
 	edit->layer = edit->layer_source;
+	edit->value_watcher = NULL;
 	edit->text_block_size = TEXT_BLOCK_SIZE;
 	edit->caret = LCUIWidget_New("textcaret");
 	w->computed_style.focusable = TRUE;
@@ -920,6 +922,10 @@ static void TextEdit_OnDestroy(LCUI_Widget widget)
 	TextLayer_Destroy(edit->layer_mask);
 	CSSFontStyle_Destroy(&edit->style);
 	TextBlocks_Clear(&edit->text_blocks);
+	if (edit->value_watcher) {
+		ObjectWatcher_Delete(edit->value_watcher);
+		edit->value_watcher = NULL;
+	}
 }
 
 static void TextEdit_OnPaint(LCUI_Widget w, LCUI_PaintContext paint,
@@ -973,6 +979,36 @@ static void TextEdit_OnUpdate(LCUI_Widget w)
 	TextStyle_Destroy(&ts);
 }
 
+static void TextEdit_OnValueChanged(LCUI_Object value, void *arg)
+{
+	LCUI_Widget w = arg;
+
+	if (value->type == LCUI_StringObject) {
+		TextEdit_SetText(w, value->value.string);
+	} else if (value->type == LCUI_WStringObject) {
+		TextEdit_SetTextW(w, value->value.wstring);
+	}
+}
+
+void TextEdit_BindProperty(LCUI_Widget w, const char *name, LCUI_Object value)
+{
+	LCUI_TextEdit edit = Widget_GetData(w, self.prototype);
+
+	if (strcmp(name, "value") == 0) {
+		if (edit->value_watcher) {
+			ObjectWatcher_Delete(edit->value_watcher);
+			edit->value_watcher = NULL;
+		}
+		if (value) {
+			edit->value_watcher =
+			    Object_Watch(value, TextEdit_OnValueChanged, w);
+			TextEdit_OnValueChanged(value, w);
+		} else {
+			TextEdit_ClearText(w);
+		}
+	}
+}
+
 void LCUIWidget_AddTextEdit(void)
 {
 	self.prototype = LCUIWidget_NewPrototype("textedit", NULL);
@@ -981,6 +1017,7 @@ void LCUIWidget_AddTextEdit(void)
 	self.prototype->destroy = TextEdit_OnDestroy;
 	self.prototype->settext = TextEdit_OnParseText;
 	self.prototype->setattr = TextEdit_SetAttr;
+	self.prototype->bindprop = TextEdit_BindProperty;
 	self.prototype->autosize = TextEdit_AutoSize;
 	self.prototype->runtask = TextEdit_OnTask;
 	self.prototype->update = TextEdit_OnUpdate;

test/test_textedit.c

@@ -9,6 +9,7 @@ int test_textedit(void)
 {
 	int ret = 0;
 	LCUI_Widget w;
+	LCUI_Object value;
 	wchar_t wcs[64];
 
 	LCUI_InitFontLibrary();
@@ -44,7 +45,27 @@ int test_textedit(void)
 	CHECK(wcslen(L"hello, world!") == TextEdit_GetTextW(w, 0, 64, wcs));
 	CHECK(wcscmp(L"hello, world!", wcs) == 0);
 
+	// test property binding
+	value = String_New("property name is 'value'");
+	Widget_BindProperty(w, "value", value);
+	Widget_Update(w);
+	CHECK(wcslen(L"property name is 'value'") == TextEdit_GetTextW(w, 0, 64, wcs));
+	CHECK(wcscmp(L"property name is 'value'", wcs) == 0);
+
+	// change property value
+	String_SetValue(value, "hello");
+	Widget_Update(w);
+	CHECK(wcslen(L"hello") == TextEdit_GetTextW(w, 0, 64, wcs));
+	CHECK(wcscmp(L"hello", wcs) == 0);
+
+	// unbind property
+	Widget_BindProperty(w, "value", NULL);
+	Widget_Update(w);
+	CHECK(0 == TextEdit_GetTextLength(w));
+
 	Widget_Destroy(w);
+	Object_Delete(value);
+
 	LCUI_FreeWidget();
 	LCUI_FreeFontLibrary();
 	return ret;