Changes between Version 49 and Version 50 of Docs/825gen2/Dev/UpdatingLegacyAppsToNewLook

Timestamp:

03/12/25 07:10:01 (3 weeks ago)

Author:

Don Wilson

Comment:

--

Docs/825gen2/Dev/UpdatingLegacyAppsToNewLook

@@ -11 +11 @@
 3. Copy code for main screen below from a standard app such as ID storage. It is likely changes will need to be made to this code to suit the particular application.
 
-{{{
+{{{#!c++
 #if ARM64
 
@@ -133 +133 @@
 4. Find the InitLCD function call and change as follows:
 
-{{{
+{{{#!c++
 void IndStartup(void)
 {
@@ -157 +157 @@
 5. Modify functions that do display operations such as shown:
 
-{{{
+{{{#!c++
 void ShowGTN(void)
 {
@@ -185 +185 @@
 6. Search for all menu and inputs forms such as search for "FORM_INIT" make appropriate changes to use new style FORM_ADD_INPUT2 instead of FORM_ADD_INPUT and FORM_ADD_BUTTON2 instead of FORM_ADD_BUTTON such as:
 
-{{{
+{{{#!c++
 void PresetScreen(void)
 {
@@ -217 +217 @@
 In the above example notice after FORM_INIT the function !SetupInputFormToUseFontSet is called. !SetupInputFormToUseFontSet is a helper function defined in apphelpers.cpp. This gives the form a pointer to the fonts that were initialized previously. The function also sets the starting positions of the rect, and rectInp rectangles that are used to define where to show the prompts and input fields. The final parameter is a string used to determine the width of the prompts. This should be the longest prompt text in the form. The !AdvanceInputRects function call is used between FORM_ADD_INPUT2 calls to move the rect and rectInp down an appropriate amount for the next input.
 
-{{{
+{{{#!c++
 EVENT(FileOperationShow)
 {
@@ -252 +252 @@
 
 Notice between FORM_ADD_BUTTON2 lines the rect is advanced by **rect += btnAdvanceY;**  The CFormRect class contains multiple values. The += operator is overloaded to allow the advance as shown. The !AdvanceInputRects function from the previous example is actually doing the same thing, but for input forms to advance both the prompt and the input rectangles.
-{{{
+{{{#!c++
 static inline void AdvanceInputRects(CFormRect& rect, CFormRect& rectInp)
 {
@@ -268 +268 @@
 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:
 
-{{{
+{{{#!c++
 #define nTimeItems 3
 const struct form_item_struct frmtm[nTimeItems] = {
@@ -303 +303 @@
 Notice in the above example a const structure defines the form. An array of void pointers (pData) is setup to point to the data items to be read/changed when the form runs. This array is passed to the FormLCD function. The above code converted to CForm style is:
 
-{{{
+{{{#!c++
 EVENT(TimeShow)
 {