CT STRUCTURED TEXT: Difference between revisions

From Bohemia Interactive Community
Jump to navigation Jump to search
m (spaces → tab)
(added warning about issues with class attributes and inheritance)
Line 25: Line 25:
shadow = 1;
shadow = 1;
};
};
|description=Subclass with options how the text should be rendered. Attributes represent the [[Structured Text]] options.<br>
|description=Subclass with options how the text should be rendered. Attributes represent the [[Structured Text]] options. {{Feature|Warning|It is impossible to inherit <tt>class attributes</tt> from an existing [[CT_STRUCTURED_TEXT]] control. While no error is shown, properties of <tt>class attributes</tt> will simply not be set. Define needed properties manually!}}
{{{!}}class="wikitable" border="1" align="left" cellpadding="3" cellspacing="0" {{!}}
{{{!}}class="wikitable" border="1" align="left" cellpadding="3" cellspacing="0" {{!}}
! colspan="4" bgcolor="#bbbbff" {{!}} Optional SubClass Attributes Properties
! colspan="4" bgcolor="#bbbbff" {{!}} Optional SubClass Attributes Properties

Revision as of 10:57, 11 June 2021

Introduction

The Structured Text control can display Structured Text. This is a separate data type in Arma. Structured Text can not only hold some text values, it also can contain some attributes to format the text, as you can see in the example picture below. You can contain a subclass Attributes to change the default attributes for your control. But the Attributes class and all of its attributes are optional and do not have to be specified.

Related commands & functions

Related User Interface Eventhandlers

Alphabetical Order

TokenNames common to most controls, such as x, y, w, h, text, idc... can be found here.
Not all of the listed attributes might have an effect nor might the list be complete. All attributes were gathered with this config crawler.
#define CT_STRUCTURED_TEXT 13


A

Attributes

Type
Class
Description
Subclass with options how the text should be rendered. Attributes represent the Structured Text options.
It is impossible to inherit class attributes from an existing CT_STRUCTURED_TEXT control. While no error is shown, properties of class attributes will simply not be set. Define needed properties manually!
Optional SubClass Attributes Properties
Name Type Remark Default Value
font string fontname to use "Zeppelin32"
size Float Set the size of the text where 1 is the size value of parent class. 1
color string text color defined in HMTL-like syntax. "#ffffff"
align string align of text. Values can be "left", "center" or "right" "center"
valign string vertical align of text. Values can be "top", "middle", "bottom". "middle"
shadow Integer affects the shadow of the text. 1 (true)
shadowColor string shadow color defined in HMTL-like syntax. "#000000"
shadowOffset
image string
underline
href string
linkColor string

class Attributes
{
	font = "RobotoCondensed";
	color = "#ffffff";
	colorLink = "#D09B43";
	align = "left";
	shadow = 1;
};



Default Classes

Arma 3
AddOns: Classes need to be initialised first with class SomeClass;

Missions: Since Arma 3 v2.02 one can use import SomeClass; to initialise a class (see the import keyword).

In older versions, use "Default" call BIS_fnc_exportGUIBaseClasses; and paste the result into the description.ext.


RscStructuredText

class RscStructuredText
{
	deletable = 0;
	fade = 0;
	access = 0;
	type = CT_STRUCTURED_TEXT;
	idc = -1;
	style = ST_LEFT;
	colorText[] = {1,1,1,1};
	class Attributes
	{
		font = "RobotoCondensed";
		color = "#ffffff";
		colorLink = "#D09B43";
		align = "left";
		shadow = 1;
	};
	x = 0;
	y = 0;
	h = 0.035;
	w = 0.1;
	text = "";
	size = GUI_TEXT_SIZE_MEDIUM;
	shadow = 1;
};


Other Examples

The following example uses almost the same code as the controls shown in the example screenshot.

class MyRscStructuredText
{
	idc = -1; 
	type = CT_STRUCTURED_TEXT;	// defined constant
	style = ST_LEFT;				// defined constant
	colorBackground[] = { 1, 1, 1, 1 }; 
	x = 0.1; 
	y = 0.1; 
	w = 0.3; 
	h = 0.1; 
	size = 0.018;
	text = "";
	class Attributes
	{
		font = "TahomaB";
		color = "#000000";
		align = "center";
		valign = "middle";
		shadow = false;
		shadowColor = "#ff0000";
		size = "1";
	};
};