Changes between Version 37 and Version 38 of Docs/825gen2/Dev/UpdatingLegacyAppsToNewLook

Timestamp:

02/09/24 08:24:16 (10 months ago)

Author:

Don Wilson

Comment:

--

Docs/825gen2/Dev/UpdatingLegacyAppsToNewLook

@@ -256 +256 @@
 Legacy code forms normally used fixed X,Y positions. It is often simpler and easier to maintain to just advance the positions. There are cases such as two column menus where at some point between FORM_ADD_BUTTON2 lines the rect position is reset to start the second column.
 
-Some especially older apps may use other styles of forms such as !DynamicForm which is a C++ style of form defined in the older lib825 instead of lib825ev. Apps may also use FormLCD which defines forms based on structs. Updating these apps will require more effort to convert them to use the newer FORM_INIT ... approach.
-
+Some apps, especially older ones may use lib825 instead of the newer lib825ev. In addition to CForm (FORM_INIT) a different method of creating forms exists in the older lib825 called !DynamicForm. These apps may also use a C++ class called the Application class. To update apps using lib825 to new style graphics it would be best to convert the app to use lib825ev (event style) apps first. Depending on the size of the app this could be a much more involved process.
+
+Apps using lib825 or lib825ev may also use FormLCD which defines forms based on structs. It is relatively simple to convert these apps to CForm (FORM_INIT) style, but will still take more time. Refer to the example below:
+
+{{{
+#define nTimeItems 3
+const struct form_item_struct frmtm[nTimeItems] = {
+{
+   // X  Y  Prompt   Len   Min   Max   Flag   Choices  Help
+   {  0, 3,  "Hour: ",  2,   0,   23,   FORM_UINT8, NULL, "Enter the hour in 24 hour time\r3 p.m. = 15" },
+   {  0, 5,  "Minute: ", 2,  0,   59,   FORM_UINT8, NULL, "Enter the minutes" },
+   {  0, 7,  "Second" ", 2,  0,   59,   FORM_UINT8, NULL, "Enter the seconds" }
+};
+
+int SetTime(void)
+{
+    int n;
+    void* pData[nTimeItems];
+
+    pData[0] = &g_datetime.hour;
+    pData[1] = &g_datetime.minute;
+    pData[2] = &g_datetime.second;
+
+    ClearLCD();
+    SetCurColor(COLOR_INFO);
+    PrintLCD("Set Time");
+
+    SetCurColor(nColorGreen);
+    n = FormLCD((struct form_item_struct*)frmtm, pData, nTimeItems, NULL, nFormFlgShowHelp);
+    if(n) {
+        // Set the time
+        // ...
+    }
+    return n;
+}
+}}}
+