summaryrefslogtreecommitdiff
path: root/design/widgets/altcombobox.tex
diff options
context:
space:
mode:
authordeva <deva>2009-02-12 15:29:50 +0000
committerdeva <deva>2009-02-12 15:29:50 +0000
commit4137259fa6071d2790173f7935f06465df324264 (patch)
tree5de78862f2aac9a3b409a90e6f4688a1cf477e23 /design/widgets/altcombobox.tex
parent34d22d96cb464feef49bb126dafa59bdf8502d94 (diff)
Lots of changes in the widget documentation...
Diffstat (limited to 'design/widgets/altcombobox.tex')
-rw-r--r--design/widgets/altcombobox.tex38
1 files changed, 38 insertions, 0 deletions
diff --git a/design/widgets/altcombobox.tex b/design/widgets/altcombobox.tex
new file mode 100644
index 0000000..dc33b29
--- /dev/null
+++ b/design/widgets/altcombobox.tex
@@ -0,0 +1,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}