Lots of changes in the widget documentation...

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}