From 604af960ebd5cc7542c710a0a10338625f81e53d Mon Sep 17 00:00:00 2001 From: deva Date: Mon, 16 Jun 2008 13:00:45 +0000 Subject: Removed include tag. Moved widgets to subfolder. Added multilist widget. --- design/xmlformat.tex | 225 +++++++-------------------------------------------- 1 file changed, 28 insertions(+), 197 deletions(-) (limited to 'design/xmlformat.tex') 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 -- cgit v1.2.3