http://docs.kde.org/
NazajReferencaNaprej

Lastnosti elementov vtičnika

Vsi elementi postavitve in vsi aktivni elementi imajo naslednje lastnosti, dostopne prek "id_of_element.name_of_property":

visible

Ali je GUI element je viden ali ne (boolean)

enabled

Ali je GUI element je omogočen ali ne (boolean)

required

Ali je GUI zahtevan (za veljavno nastavitev) ali ne. Upoštevajte, da je vsak element, ki je onemogočen ali skrit, tudi implicitno neobvezen (boolean).

Poleg tega imajo nekateri elementi dodatne lastnosti, s katerimi se lahko povežete. Večina aktivnih elementov ima tudi lastnost privzeto "default", katere vrednost bo vrnjena pri klicih getBoolean/getString/getList ("..."), če nobena posebna lastnost ni bila imenovana, kot je opisano spodaj.

<text>

Privzeta lastnost je besedilo

text

Prikazano besedilo (besedilo)

<varselector>

Ni privzete lastnosti

selected

Trenutno izbrani predmeti. Verjetno tega ne želite uporabiti. Uporablja se interno (RObject)

root

Korenski/nadrejeni objekt predmetov, ponujenih za izbor (RObject)

<varslot>

Privzeta lastnost je "available"

available

Vsi predmeti, shranjeni v reži varslot (RObject)

selected

Od predmetov, shranjenih v varslot, tisti, ki so trenutno izbrani. Verjetno tega ne želite uporabiti. Uporablja se interno (RObject)

source

Kopija predmetov, izbranih v ustreznem izbirniku spremenljivk varselector. Verjetno tega ne želite uporabiti. Uporablja se interno (RObject)

<valueselector>

Privzeta lastnost je "selected"

selected

Trenutno izbrani nizi. Modifikator "labeled" za pridobitev ustreznih oznak. V <valueselector> tega verjetno ne želite uporabiti neposredno (samo v <select>). (read/write StringList)

available

Seznam vrednosti niza, med katerimi lahko izbirate. (read/write StringList)

labels

Oznake za prikaz vrednosti niza. (read/write StringList)

<valueslot>

Enako kot <varslot>, vendar so lastnosti seznami nizov namesto RObjects.

<radio>

Privzeta lastnost je "string"

string

Vrednost trenutno izbrane možnosti (string)

number

Število trenutno izbrane možnosti (možnosti so oštevilčene od zgoraj navzdol, z začetkom pri 0) (celo število)

<dropdown>

Enako kot <radio>

<select>

Enako kot <valueselector>

<option>

Ni privzete lastnosti. "enabled" je *edina* lastnost in trenutno ni na voljo za možnosti znotraj <select> ali <valueselector>. <option> nima "visible" ali "required" lastnosti.

enabled

Ali naj bo ta posamezna možnost omogočena ali onemogočena. V večini primerov boste omogočili/onemogočili celoten <radio< ali namesto tega <dropdowni<. Toda to je mogoče uporabiti za dinamično nastavitev omogočenosti posamezne možnosti znotraj <radio< ali <dropdowni< (bool)

<checkbox>

Privzeta lastnost je "state.labeled", kar pomeni, da so vrnjene vrednosti, določene z atributoma value in value_unchecked, ne prikazane oznake potrditvenega polja.

state

Stanje potrditvenega polja (vklopljeno ali izklopljeno). Upoštevajte, da so uporabni modifikatorji te lastnosti (kot vseh logičnih lastnosti) "not" in "labeled" (glejte vrste lastnosti). Vendar je pogosto najbolj uporabno povezati se z lastnostjo brez modifikatorja, tj. "checkbox_id.state", ki bo vrnil stanje potrditvenega polja v obliki, primerni za uporabo v stavku if (0 ali 1). (boolova vrednost)

<frame>

Privzeta lastnost je "checked", če - in samo če - je okvir mogoče preveriti. Za okvirje, ki jih ni mogoče preveriti, ni privzete lastnosti.

checked

Na voljo samo za okvirje, ki jih je mogoče preveriti: stanje potrditvenega polja (vklopljeno ali izklopljeno). Upoštevajte, da sta uporabna modifikatorja te lastnosti (kot vseh logičnih lastnosti) "not" in "numeric" (glejte vrste lastnosti). (boolova vrednost)

<input>

Privzeta lastnost je "text"

text

Trenutno besedilo v vnosnem polju (niz)

<matrix>

Privzeta lastnost je "cbind".

rows

Število vrstic v matriki (celo število). Če matrika uporabniku omogoča dodajanje / odstranjevanje vrstic, je treba to lastnost obravnavati kot samo za branje. V nasprotnem primeru bo sprememba spremenila velikost matrike.

columns

Število stolpcev v matriki (celo število). Če matrika dovoljuje uporabniku dodajanje/odstranjevanje stolpcev, je treba to lastnost obravnavati kot samo za branje. V nasprotnem primeru bo sprememba spremenila velikost matrike.

tsv

Podatki v matriki v formatu tsv (string; branje-pisanje). Upoštevajte, da so v primerjavi z običajno postavitvijo tsv stolpci columns, ne vrstice, ločeni z znaki za novo vrstico, celice v stolpcu pa so ločene z znaki tabulatorja.

0,1,2...

Podatki iz enega samega stolpca (0 za skrajno levi stolpec). getValue()/getString() to vrne kot en sam niz, ločen z "\n". Vendar pa je priporočeni način za to uporaba getList(), ki ta stolpec vrne kot niz nizov.

row.0,row.1,row.2...

Podatki iz ene same vrstice (0 za najvišjo vrstico). getValue()/getString() to vrne kot en sam niz, ločen z "\n". Vendar pa je priporočeni način za to uporaba getList(), ki vrne to vrstico kot niz nizov.

cbind

Podatki v formatu, primernem za lepljenje v R, zaviti v stavek cbind (niz; samo za branje).

<optionset>

Ni privzete lastnosti.

row_count

Število elementov v naboru možnosti optionset (celo število). Samo za branje.

current_row

Trenutno aktivni element v naboru možnosti optionset (celo število). -1 za noben aktivni element. Branje-pisanje.

optioncolumn_ids

Za vsak <optioncolumn>, ki ga definirate, bo ustvarjena lastnost seznama nizov s podanim ID-jem.

<browser>

Privzeta lastnost je "selection"

selection

Trenutno besedilo (ime izbrane datoteke) v brskalniku (niz)

prepiši

Ali je potrjena možnost "prepiši" (logična vrednost, samo za branje, tj. lahko stanje potrditvenega polja samo preberete, programsko pa ga ne morete spremeniti)

<saveobject>

Privzeta lastnost je "selection"

selection

Polno ime izbranega predmeta (niz; samo za branje – če želite to nastaviti programsko, uporabite "parent" in "objectname")

parent

Nadrejeni predmet izbranega predmeta. To je vedno obstoječi R objekt vrste, ki lahko vsebuje druge objekte (npr. seznam ali data.frame). Ko je nastavljen na prazen niz ali neveljaven predmet, se predpostavlja ".GlobalEnv" (RObject)

objectname

Osnovno ime izbranega predmeta, tj. niz, ki ga je vnesel uporabnik (po potrebi spremenjen v veljavno R ime) (niz)

active

Samo za objekte shranjevanja, ki jih je mogoče preveriti: ali je kontrolnik označen/omogočen. Vedno velja za predmete shranjevanja, ki jih ni mogoče preveriti (bool)

<spinbox>

Privzeta lastnost je "int" ali "real.formatted", odvisno od načina vrtilnega polja

int

Vrednost celega števila, ki jo hrani vrtilno polje, ali najbližje celo število, če je v realnem načinu (celo število)

real

Realna vrednost, ki jo hrani vrtilno polje (in celo število, če je celo število) (realno)

<formula>

Privzeta lastnost je "model"

model

Trenutni niz modela (niz)

table

Data.frame, ki vsebuje zahtevane spremenljivke. Če so uporabljene spremenljivke samo iz enega data.frame, se vrne ime tega data.frame. V nasprotnem primeru se po potrebi sestavi nov data.frame (niz)

labels

Če so vključene spremenljivke iz več data.frameov, se lahko njihova imena pokvarijo (na primer, če oba data.frames vsebujeta spremenljivko z imenom "x"). To vrne seznam s pokvarjenimi imeni kot indeksi in opisno oznako kot vrednost (niz)

fixed_factors

Fiksni faktorji. Verjetno tega ne želite uporabiti. Uporablja se interno (RObject)

dependent

Odvisna spremenljivka(e). Verjetno tega ne želite uporabiti. Uporablja se interno (RObject)

<embed>

Ni privzete lastnosti

code

Koda, ki jo ustvari vdelani vtičnik (code)

<preview>

Privzeta lastnost je "state"

state

Ali je polje za predogled potrjeno (ni nujno, ali je bil predogled že prikazan) (boolean)

<convert>

Ta element (uporabljen v razdelku <logic>) je poseben, ker je tehnično *je* lastnost, namesto da samo drži eno ali več lastnosti. Je boolove vrste. Upoštevajte, da sta uporabna modifikatorja te lastnosti (kot vseh boolovih lastnosti) "not" in "numeric" (glejte vrste lastnosti)

<switch>

Ta element (uporabljen v razdelku <logic>) je poseben, ker je tehnično *je* lastnost (niz), namesto da samo drži eno ali več lastnosti. Omogoča preklapljanje med več ciljnimi lastnostmi glede na vrednost lastnosti pogoja ali ponovno preslikavo vrednosti lastnosti pogoja. Vsi modifikatorji, ki jih podate, se posredujejo ciljnim lastnostim, tako npr. če so vse ciljne lastnosti lastnosti RObject, lahko na stikalu uporabite tudi modifikator "shortname". Če pa so ciljne lastnosti različnih vrst, lahko uporaba modifikatorjev povzroči napake. Za fixed_values je vsak modifikator tiho opuščen. Upoštevajte, da so ciljne lastnosti, ko do njih dostopate prek stikala, vedno samo za branje.