Lua:Neutrino-API:ctext:de

Aus TuxBoxWIKI
Wechseln zu: Navigation, Suche

ctext

Erzeugt eine Textbox

ctext.new{Parameter}


Parameter:

Parameter Typ Description/Beschreibung
parent userdata Übergeordnetes cwindow-Fenster siehe Übergeordnete Fenster
x number x-Koordinate der Textbox auf dem Bildschirm
y number y-Koordinate der der Textbox auf dem Bildschirm
dx number Breite der Textbox
dy number Höhe der Textbox
text string Anzuzeigender Text
text_mode string Flags zur Beeinflussung der Anzeige, Hinweis: ab API v1.82 mode veraltet, weiterhin verfügbar ALIGN_AUTO_WIDTH
ALIGN_AUTO_HIGH
ALIGN_SCROLL
ALIGN_CENTER
ALIGN_RIGHT
ALIGN_TOP
ALIGN_BOTTOM
ALIGN_NO_AUTO_LINEBREAK
DECODE_HTML
font_text number Font für die Textdarstellung default: MENU
has_shadow string Schatten Ein / Aus default: false (Aus)
color_text number Farbe für die Textdarstellung default: MENUCONTENT_TEXT
color_frame number Farbe für den Rahmen default: MENUCONTENT_PLUS_6
color_body number Farbe für den Hintergrund default: MENUCONTENT_PLUS_0
color_shadow number Farbe für den Schatten default: MENUCONTENTDARK_PLUS_0
en: Parameters with default-values are optional. If not needed, no definition is required. In case of missing parameter, default value is used.

de: Parameter mit Default-Wert sind optional. dh. sie müssen nicht angegeben werden. Falls der Parameter fehlt, wird automatisch dieser Wert angenommen.


Example:

local ct1;
local ct2;
local n = neutrino();

function neutrinoExec()
	repeat
		msg, data = n:GetInput(500)
		-- Taste Rot versteckt den Text
		if (msg == RC['red']) then
			ct2:hide();
		-- Taste Grün zeigt den Text wieder an
		elseif (msg == RC['green']) then
			ct2:paint();
		-- Mit den Tasten up/down bzw. page_up/page_down kann der Text gescrollt werden,
		-- falls erforderlich
		elseif (msg == RC['up'] or msg == RC['page_up']) then
			ct2:scroll{dir="up"};
		elseif (msg == RC['down'] or msg == RC['page_down']) then
			ct2:scroll{dir="down"};
		end
	-- Taste Exit oder Menü beendet das Fenster
	until msg == RC['home'] or msg == RC['setup'];
end

local text1 = "-- Die Überschrift --";
local text2 = "Hier eine Textzeile.\n\nWeiterer Text...";
local spacer = 8;
local x  = 250;
local y  = 150;
local dx = 800;
local dy = 300;
local fh_title = n:FontHeight(FONT['MENU_TITLE']);

-- Fenster erzeugen und anzeigen
local w = cwindow.new{x=x, y=y, dx=dx, dy=dy, title="Lua - CComponentsText", btnRed="Text hide", 
			btnGreen="Text paint"};
w:paint();

local x1  = x + spacer;
local y1  = y + w:header_height() + spacer;
local dx1 = dx - spacer*2;
local dy1 = fh_title;

-- Text1 (Überschrift) erzeugen und anzeigen
ct1 = ctext.new{x=x1, y=y1, dx=dx1, dy=dy1, text=text1, mode="ALIGN_AUTO_WIDTH | ALIGN_CENTER",
			font_text=FONT['MENU_TITLE']};
ct1:paint();

y1 = y1 + fh_title + spacer*2;
dy1 = 70;

-- Text2 erzeugen und anzeigen
ct2 = ctext.new{x=x1, y=y1, dx=dx1, dy=dy1, text=text2, 
			mode="ALIGN_AUTO_WIDTH | ALIGN_AUTO_HIGH | ALIGN_TOP | ALIGN_SCROLL",
			font_text=FONT['MENU']};
ct2:paint();

neutrinoExec();

ct1:hide();
ct2:hide();
w:hide();


Beispiel 1

paint

Zeichnet ein ctext-Feld auf den Bildschirm

ctext.paint{Parameter}


Parameter:

Parameter Typ Description/Beschreibung
do_save_bg boolean Gibt an, ob der Hintergrund des Elements gesichert werden soll default: true
en: Parameters with default-values are optional. If not needed, no definition is required. In case of missing parameter, default value is used.

de: Parameter mit Default-Wert sind optional. dh. sie müssen nicht angegeben werden. Falls der Parameter fehlt, wird automatisch dieser Wert angenommen.


Example:

ct:paint{do_save_bg=true};


hide

Löscht ein ctext-Feld vom Bildschirm

ctext.hide{Parameter}


Parameter:

Parameter Typ Description/Beschreibung
no_restore boolean Gibt an, ob gespeicherte Bildschirmdaten gelöscht werden sollen (wenn verfügbar) default: false
en: Parameters with default-values are optional. If not needed, no definition is required. In case of missing parameter, default value is used.

de: Parameter mit Default-Wert sind optional. dh. sie müssen nicht angegeben werden. Falls der Parameter fehlt, wird automatisch dieser Wert angenommen.


Example:

ct:hide{no_restore=true};


scroll

Scollt ein ctext-Feld auf dem Bildschirm

ctext.scroll{Parameter}


Parameter:

Parameter Typ Description/Beschreibung
scroll string Gibt an, in welche Richtung der Text gescrollt werden soll Mögliche Werte: "up", "down"
en: Parameters with default-values are optional. If not needed, no definition is required. In case of missing parameter, default value is used.

de: Parameter mit Default-Wert sind optional. dh. sie müssen nicht angegeben werden. Falls der Parameter fehlt, wird automatisch dieser Wert angenommen.


Example:

ct:scroll{dir="down"};


setText

Setzt den Text des Textfeldes

ctext.setText {Parameter}


Parameter:

Parameter Typ Description/Beschreibung
text string Anzuzeigender Text
mode string Flags zur Beeinflussung der Anzeige default: angegebener Wert bei new
font_text number Font für die Textdarstellung default: angegebener Wert bei new
en: Parameters with default-values are optional. If not needed, no definition is required. In case of missing parameter, default value is used.

de: Parameter mit Default-Wert sind optional. dh. sie müssen nicht angegeben werden. Falls der Parameter fehlt, wird automatisch dieser Wert angenommen.


Example:

w:setText{text="Huhu..."};