Label - Revision history

Tectu: /* API reference */

2021-08-19T13:38:45Z

‎API reference

Tectu: /* Example */

2021-08-19T13:28:45Z

‎Example

Tectu: /* Example */

2021-08-19T13:28:29Z

‎Example

Tectu at 18:20, 6 August 2021

2021-08-06T18:20:28Z

Tectu: /* Border */

2021-08-06T18:20:12Z

‎Border

Tectu: /* Example */

2021-08-06T18:10:53Z

‎Example

Tectu: /* Attribute */

2021-08-06T18:10:33Z

‎Attribute

Tectu: /* API reference */

2016-02-04T15:47:56Z

‎API reference

Tectu: /* Example */

2016-02-01T12:19:14Z

‎Example

Tectu: /* Attribute */

2016-01-08T20:11:06Z

‎Attribute

@@ Line 3: / Line 3: @@
 == API reference ==
-The API reference of the label widget can be found [http://api.ugfx.org/group___label.html here].
+The API reference of the label widget can be found [http://api.ugfx.io/group___label.html here].
 == Border ==

@@ Line 71: / Line 71: @@
      while(1) {
-         gwinSetText(ghLabel1, "This is some text", TRUE);
+         gwinSetText(ghLabel1, "This is some text", gTrue);
          gfxSleepMilliseconds(1000);
-         gwinSetText(ghLabel1, "Aaaand some other text", TRUE);
          gfxSleepMilliseconds(1000);
+     }

@@ Line 42: / Line 42: @@
 static void createWidgets(void)
+{
-	GWidgetInit		wi;
+    GWidgetInit wi;
-	// Apply some default values for GWIN
+    // Apply the label parameters
-	wi.customDraw = 0;
+    wi.g.show = gTrue;
-	wi.customParam = 0;
+    wi.g.y = 10;
-	wi.customStyle = 0;
+    wi.g.x = 10;
-	wi.g.show = gTrue;
+    wi.g.width = 100;
-	// Apply the label parameters
+    // Create the actual label
-	wi.g.y = 10;
+    ghLabel1 = gwinLabelCreate(NULL, &wi);
-	wi.g.x = 10;
-	wi.g.width = 100;
-	wi.g.height = 20;
-	wi.text = "Label 1";
-−
-	// Create the actual label
-	ghLabel1 = gwinLabelCreate(NULL, &wi);
+}
 int main(void)
+{
-	// Initialize the uGFX library
+    // Initialize the uGFX library
-	gfxInit();
+    gfxInit();
-	// Set the widget defaults
+    // Set the widget defaults
-	gwinSetDefaultFont(gdispOpenFont("UI2"));
+    gwinSetDefaultFont(gdispOpenFont("UI2"));
-	gwinSetDefaultStyle(&WhiteWidgetStyle, FALSE);
+    gwinSetDefaultStyle(&WhiteWidgetStyle, FALSE);
-	gdispClear(White);
+    gdispClear(White);
-	// Create the widget
+    // Create the widget
-	createWidgets();
+    createWidgets();
-	while(1) {
+    while(1) {
-		gwinSetText(ghLabel1, "This is some text", TRUE);
+        gwinSetText(ghLabel1, "This is some text", TRUE);
-		gfxSleepMilliseconds(1000);
+        gfxSleepMilliseconds(1000);
-		gwinSetText(ghLabel1, "Aaaand some other text", TRUE);
+        gwinSetText(ghLabel1, "Aaaand some other text", TRUE);
-		gfxSleepMilliseconds(1000);
+        gfxSleepMilliseconds(1000);
-−
+    }
-	return 0;
+    return 0;
+}
 </source>
 [[Category:Widget]]

@@ Line 1: / Line 1: @@
 A label is a simple rectangular widget which takes no input. The label will automatically redraw it the text changed. If the label is smaller than the text it displays, the text gets clipped.
-The text of the label can be set using the ''gwinSetText()'' routine.
+The text of the label can be set using the <code>gwinSetText()</code> routine.
 == API reference ==

@@ Line 6: / Line 6: @@
 == Border ==
-The default drawing routine of the labels allows to enable or disable a border. This can be done using gwinLabelSetBorder().
+The default drawing routine of the labels allows to enable or disable a border. This can be done using <code>gwinLabelSetBorder()</code>.
 == Auto scale ==

@@ Line 31: / Line 31: @@
 DHCP:       On
 </pre>
-'''IMPORTANT:''' It's highly discouraged to use the attribute feature. The proper way of doing this is using two separate labels. This feature exists purely for legacy reasons. Back the old days there was no [http://studio.ugfx.org µGFX-Studio] that allows to copy and align multiple labels easily in a blink of a second.
+'''IMPORTANT:''' Use of the attribute capability is discouraged. This feature should be considered deprecated and will be removed in future releases. The proper way of doing this is using two separate labels.
 == Example ==

@@ Line 35: / Line 35: @@
 == Example ==
 The following example shows how to create a label.
-<syntaxhighlight lang="php">
+<source lang="php">
 #include "gfx.h"
 static GHandle ghLabel1;
-static void createWidgets(void) {
+static void createWidgets(void)
 	GWidgetInit		wi;
@@ Line 60: / Line 61: @@
+}
-int main(void) {
+int main(void)
-	// Initialize the display
 	gfxInit();
@@ Line 69: / Line 71: @@
 	gdispClear(White);
-	// create the widget
+	// Create the widget
 	createWidgets();
@@ Line 81: / Line 83: @@
 	return 0;
+}
-</syntaxhighlight>
+</source>
 [[Category:Widget]]

@@ Line 24: / Line 24: @@
 == Attribute ==
-Often you want to display multiple text elements below each other where an element consists of a static text which will always be the same and some variable one. The static text is called the attribute and can be optionally set through <code>gwinLabelSetAttribute()</code> once you enabled this feature in your gfxconf.h. The function does also take a tab parameter which allows to align multiple labels vertically as the following example shows:
+Often you want to display multiple text elements below each other where an element consists of a static text which will always be the same and some variable one. The static text is called the attribute and can be optionally set through <code>gwinLabelSetAttribute()</code> once you enabled this feature in your [[configuration|configuration file]]. The function does also take a tab parameter which allows to align multiple labels vertically as the following example shows:
 <pre>