summaryrefslogtreecommitdiff
path: root/design/xmlformat.tex
diff options
context:
space:
mode:
authordeva <deva>2008-06-16 13:00:45 +0000
committerdeva <deva>2008-06-16 13:00:45 +0000
commit604af960ebd5cc7542c710a0a10338625f81e53d (patch)
treefd699f3232f036f260c75e6c94dd976f8d9baa24 /design/xmlformat.tex
parenta5d78e33085399d04fabeacf8142dbfe55992e7a (diff)
Removed include tag. Moved widgets to subfolder. Added multilist widget.
Diffstat (limited to 'design/xmlformat.tex')
-rw-r--r--design/xmlformat.tex225
1 files changed, 28 insertions, 197 deletions
diff --git a/design/xmlformat.tex b/design/xmlformat.tex
index 894d517..9daaf89 100644
--- a/design/xmlformat.tex
+++ b/design/xmlformat.tex
@@ -101,18 +101,21 @@ Makroen har flg. attributter:
Dette felt må ikke udelades.
\end{itemize}
-\subsubsection{\texttt{include} elementet}
-Include elementet kan kun frekomme serverside, hvor det vil blive
-udvidet med den angivne makro.\\
-Serveren indsætter alle elementer fra (og ikke med) makroens rodvindue
-og indad på det sted hvor include elementet befinder sig.\\
-Include har flg. attributter:
-\begin{itemize}
-\item \textit{name} - Navnet på den makro som skal inkluderes.
-\item \textit{disabled} - Angiver om den indsatte makro skal
- disables. Kan have værdierne ``true'' eller ``false''. Hvis udeladt
- benyttes værdien ``false''.
-\end{itemize}
+%%
+%% This element has been removed
+%%
+%\subsubsection{\texttt{include} elementet}
+%Include elementet kan kun frekomme serverside, hvor det vil blive
+%udvidet med den angivne makro.\\
+%Serveren indsætter alle elementer fra (og ikke med) makroens rodvindue
+%og indad på det sted hvor include elementet befinder sig.\\
+%Include har flg. attributter:
+%\begin{itemize}
+%\item \textit{name} - Navnet på den makro som skal inkluderes.
+%\item \textit{disabled} - Angiver om den indsatte makro skal
+% disables. Kan have værdierne ``true'' eller ``false''. Hvis udeladt
+% benyttes værdien ``false''.
+%\end{itemize}
\subsubsection{Generelle GUI attributter}
Alle GUI elementerne i xml dokumentet har flg. attributter:
@@ -136,191 +139,19 @@ Alle GUI elementerne i xml dokumentet har flg. attributter:
samt alle dets children rekursivt. Hvis undladt benyttes værdien ``false''.
\end{itemize}
-\subsubsection{\texttt{window} elementet}
-Et vindue benyttes som moder element, til at indsætte andre elementer
-i. Det vil optræde som et vindue på skærmen med kanter, vinduestitel,
-ikon osv.\\
-Et vindue har flg. attributter:
-\begin{itemize}
-\item \textit{caption} - Den tekst som skal vises i labelen. Hvis
- udeladt vises ingen tekst i elementet.
-\item \textit{fixed} - Angiver om vinduet kan skaleres eller om det er
- statisk. Kan have værdierne ``true'' eller ``false''. Hvis udeladt
- vil vinduet kunne skaleres.
-\item \textit{layout} - Vinduets layout engine. Kan have værdierne
- ``hbox'' eller ``vbox''. Hvis udeladt benyttes et vbox layout.
-\end{itemize}
-
-\subsubsection{\texttt{frame} elementet}
-En frame benyttes til at indsætte nestede elementer i makroen, såsom
-gruperinger af checkboxe.\\
-En frame har flg. attributter:
-\begin{itemize}
-\item \textit{caption} - Den tekst som skal vises i framen. Hvis
- udeladt vises framen som en tom ramme.
-\item \textit{border} - Elementets kant type. Kan have værdierne
- ``plain'' eller ``raised'' Hvis udeladt benyttes laves ingen kant.
-\item \textit{padding} - En integer som er størelsen på paddingen på
- elementet. Hvis udeladt benyttes elementets default padding.
-\item \textit{margin} - En integer som er størelsen på elementets
- margin. Hvis udeladt benyttes elementets default margin.
-\item \textit{layout} - Framens layout engine. Kan have værdierne
- ``hbox'' eller ``vbox''. Hvis udeladt benyttes et vbox layout.
-\end{itemize}
-
-\subsubsection{\texttt{spacer} elementet}
-Et spacer element bruges for at pakke andre elementer i et layout.\\
-En spacer har ingen attributter.
-
-\subsubsection{\texttt{label} elementet}
-En label benyttes til at indsætte beskrivejnde tekst i makroen.\\
-En label har flg. attributter:
-\begin{itemize}
-\item \textit{caption} - Den tekst som skal vises i labelen. Hvis
- udeladt vises ingen tekst i elementet.
-\item \textit{alignment} - Justeringen af teksten. Kan have værdierne
- ``left'', ``right'' eller ``center''. Hvis udeladt benyttes ``left''.
-\end{itemize}
-
-\subsubsection{\texttt{lineedit} elementet}
-En lineedit benyttes til at læse input fra brugeren i kraft tekst.\\
-Lineediten kan have et regulært udtryk tilknyttet, som validerer input
-mens der tastes og ændrer feltets baggrundsfarve afhængig af om feltet
-indeholder valid data eller ej.\\
-Feltet er et et linies felt.\\
-En lineedit har flg. attributter:
-\begin{itemize}
-\item \textit{value} - Den tekst som skal vises i lineediten. Hvis
- udeladt vil lineediten være tom.
-\item \textit{regexp} - Et regulært udtryk som benyttes til at
- validere feltet. Hvis udeladt accepterer feltet alle inputs. Læs
- mere om de regulære udtryk her:
- \verb|http://doc.trolltech.com/4.3/qregexp.html#introduction|
-\end{itemize}
-
-\subsubsection{\texttt{textedit} elementet}
-En textedit benyttes ligesom lineedit til at læse input fra brugeren i
-kraft af tekst.\\
-Textediten kan have et regulært udtryk tilknyttet, som validerer input
-mens der tastes og ændrer feltets baggrundsfarve afhængig af om feltet
-indeholder valid data eller ej.\\
-Feltet er modsat lineedit et flerliniers felt.\\
-En textedit har flg. attributter:
-\begin{itemize}
-\item \textit{value} - Den tekst som skal vises i textediten. Hvis
- udeladt vil textediten være tom.
-\item \textit{regexp} - Et regulært udtryk som benyttes til at
- validere feltet. Hvis udeladt accepterer feltet alle inputs. Læs
- mere om de regulære udtryk her:
- \verb|http://doc.trolltech.com/4.3/qregexp.html#introduction|
-\end{itemize}
-
-\subsubsection{\texttt{button} elementet}
-En knap kan benyttes til enten at afbryde makroen eller at acceptere
-dens indhold og dermed gemme dataene på serveren.\\
-En knap har flg. attributter:
-\begin{itemize}
-\item \textit{caption} - Den tekst som skal vises i knappen. Hvis
- udeladt vises knappen uden tekst.
-\item \textit{action} - Den handling som skal udføres når der trykkes
- på knappen. Kan være ``abort'', ``commit'' eller ``reset'', hvor ``abort''
- afbryder makroen, ``commit'' gemmer makroen i databasen og i
- journalen og ``reset'' fjerner alle indtastede data. Hvis udeladt
- vil en inaktiv knap blive produceret.
-\end{itemize}
-
-\subsubsection{\texttt{checkbox} elementet}
-En checkbox bruges til at aktivere eller deaktivere en given værdi ved
-hjælp af flueben.\\
-En checkbox har flg. attributter:
-\begin{itemize}
-\item \textit{caption} - Den tekst som skal vises i knappen. Hvis
- udeladt vises checkboxen uden tekst.
-\item \textit{value} - Den værdi som checkboxen har intielt. Kan
- ``true'' eller ``false''. Hvis udeladt vil checkboxen få værdien
- ``false''.
-\end{itemize}
-
-\subsubsection{\texttt{togglebutton} elementet}
-En togglebutton bruges til at aktivere eller deaktivere en given værdi ved
-brug af en trykknap.\\
-En togglebutton har flg. attributter:
-\begin{itemize}
-\item \textit{caption} - Den tekst som skal vises i knappen. Hvis
- udeladt vises knappen uden tekst.
-\item \textit{value} - Den værdi som knappen har intielt. Kan
- ``true'' eller ``false''. Hvis udeladt vil den få værdien
- ``false''.
-\end{itemize}
-
-\subsubsection{\texttt{radiobuttons} elementet}
-En radiobuttons gruppe bruges til at vælge et element ud af en gruppe
-via radiobuttons.\\
-Radiobuttons gruppen har flg. attributter:
-\begin{itemize}
-\item \textit{value} - Inidikerer hvilken radiobutton i gruppen som skal være
- valgt initielt. Hvis udeladt eller ikke-matchende vil ingen radiobutton være
- valgt, hvilket vil svare til at et regulært udtryk på et tekstfelt ikke er
- opfyldt.
-\item \textit{layout} - Vinduets layout engine. Kan have værdierne
- ``hbox'' eller ``vbox''. Hvis udeladt benyttes et vbox layout.
-\end{itemize}
-Radiobuttons indeholder \texttt{item} tags som beskriver hvilke valgmuligheder
-den givne gruppe har.\\
-Et radiobutton item har flg. attributter:
-\begin{itemize}
-\item \textit{caption} - Den tekst som skal vises i radiobuttonen. Hvis
- udeladt vises radiobuttonen uden tekst.
-\item \textit{value} - Den værdi som radiobuttonen har og som sendes som værdi
- af gruppen hvis denne radiobutton er valgt ved commit.
-\end{itemize}
-Ved commit returneres radiobutton gruppens navn med den valgte radiobuttons value.
-
-\subsubsection{\texttt{combobox} elementet}
-En combobox gruppe bruges til at vælge et element ud af en gruppe.\\
-En combobox har flg. attributter:
-\begin{itemize}
-\item \textit{value} - Inidikerer hvilket element i gruppen som skal være
- valgt initielt. Hvis udeladt eller ikke-matchende vil comboboxen være tom,
- hvilket vil svare til at et regulært udtryk på et tekstfelt ikke er
- opfyldt.
-\end{itemize}
-Comboboxen indeholder \texttt{item} tags som beskriver hvilke valgmuligheder
-den givne gruppe har.\\
-Et combobox 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.
-\end{itemize}
-Ved commit returneres comboboxens navn med det valgte items value.
-
-\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} - Inidikerer 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.
+\input{widgets/window}
+\input{widgets/frame}
+\input{widgets/spacer}
+\input{widgets/label}
+\input{widgets/lineedit}
+\input{widgets/textedit}
+\input{widgets/button}
+\input{widgets/checkbox}
+\input{widgets/togglebutton}
+\input{widgets/radiobuttons}
+\input{widgets/combobox}
+\input{widgets/listbox}
+\input{widgets/multilist}
\subsection{Commit}
En commit sektion sendt til serveren skal bevirke at serveren lagrer de