summaryrefslogtreecommitdiff
path: root/design/widgets/altcombobox.tex
blob: dc33b29177b00634e25d5bceb4b70565ec2bb6a7 (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
37
38
% -*- coding: utf-8 -*-
\subsubsection{\texttt{altcombobox} elementet}
\label{altcombobox}
En altcombobox fungerer fuldstændigt som en combobox (se kapitel \ref{combobox}),
men den ene undtagelse at den udover item tags indeholder altitem tags.\\
Dens funktion er udover at stille elementer til rådighed for udvælgelse, at give
mulighed for at udfylde en alternativ widget istedet, men under samme navn.\\
En altcombobox har samme attributer som combobox.\\
\\
Altcomboboxen indeholder udover item tags også et (og kun et) \texttt{altitem} tag
som igen indeholder den widget som skal bruges som altrenativ.\\
Et altitem tag 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} - En værdi som kun bruges internt af systemet, men stadig
  skal være unikt genkendelig fra de andre navne hos item tagsne.
\item \textit{layout} - ``vbox'' eller ``hbox'', beskriver hvordan de indre widgets
  skal lægges ud.
\item \textit{innerwidget} - Navnet på den af de indre widgets som skal benyttes
  som værdien hvis altitem'et er valgt.
\end{itemize}
Ved commit returneres altcomboboxens navn med det valgte items value, eller værdien
af den indre widget.\\
Ved sætning af data til altcomboboxen vil dne først forsøg at vælge et af de
almindelige items, og hvis dette fejler, sætte værdien på dens indre widget.

\begin{lstlisting}[title={Et eksempel på et altcombobox tag med item tags og et altitem tag indeni.}]
<altcombobox name="foobar" value="option1" layout="vbox">
  <item caption="Option 1" value="option1"/>
  <item caption="Option 2" value="option2"/>
  <altitem caption="Option 3" value="option3" innerwidget="foo"
           layout="vbox">
    <label caption="Bar:"/>
    <lineedit name="foo" value="test"/>
  </altitem>
</altcombobox>
\end{lstlisting}