summaryrefslogtreecommitdiff
path: root/design/widgets/listbox.tex
blob: 992cbdea8cd381af699560bca1aa2913db1fc0e3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
% -*- coding: utf-8 -*-
\subsubsection{\texttt{listbox} elementet}
En listbox bruges til at vælge præcis et element ud af en gruppe via en liste.\\
En listbox har flg. attributter:
\begin{itemize}
\item \textit{value} - Indikerer hvilket element på listen som skal være
  valgt initielt. Hvis udeladt eller ikke-matchende vil ingenting være valgt,
  hvilket vil svare til at et regulært udtryk på et tekstfelt ikke er
  opfyldt.
\end{itemize}
Listboxen indeholder \texttt{item} tags som beskriver hvilke linier der skal
være i listen.\\
Et listbox item har flg. attributter:
\begin{itemize}
\item \textit{caption} - Den tekst som skal vises for denne valgmulighed. Hvis
  udeladt vises den uden tekst.
\item \textit{value} - Den værdi som valgmuligheden har og som sendes som værdi
  af gruppen hvis den er valgt ved commit. Skal udelades hvis type er sat.
\item \textit{type} - Et typefelt, som beskriver hvordan dette item skal vise.
  Kan have værdierne ``separator'', hvilket indikerer at elementet skal vises
  som en horisontal streg der ikke kan vælges, eller ``header'' som indikerer at
  elementet skal vises som en overskrift der ikke kan vælges. Når typen er sat
  til ``header'' benyttes \textit{caption} attributen som den tekst der skal
  vises i overskriften.
\end{itemize}
Ved commit returneres listboxens navn med det valgte items value.

\begin{lstlisting}[title={Et eksempel på et listbox tag med item tags indeni.}]
<listbox name="foobar" value="option1" layout="vbox">
  <item caption="Option 1" value="option1"/>
  <item type="separator"/>
  <item caption="Option 2" value="option2"/>
  <item type="header" caption="En overskrift"/>
  <item caption="Option 3" value="option3"/>
</listbox>
\end{lstlisting}