summaryrefslogtreecommitdiff
path: root/design/widgets/listbox.tex
blob: dd9fe1915fd78382378b6712ad876cadf5ce39d8 (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
% -*- 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.