\section{Listview.mui}

It's important to know that MUI makes a difference
between a list and a listview. A list is just a
collection of some entries and is part of a listview,
which attaches a scrollbar and input handling to
the list.

During object creation time, you have to be careful
not specifying listview tags for the list object
or list tags for the listview object, both versions
won't work. Once the objects are setup, you can
of course talk to the listview as if it was the
list directly.

\subsection[MUIA\_Listview\_ClickColumn]{MUIA\_Listview\_ClickColumn -- (V7) [..G], LONG}

\subsubsection*{FUNCTION}
When using a multi column list, this attribute contains the number of
the column where the user clicked.

\subsubsection*{SEE ALSO}
MUIA\_Listview\_DefClickColumn

\subsection[MUIA\_Listview\_DefClickColumn]{MUIA\_Listview\_DefClickColumn -- (V7) [ISG], LONG}

\subsubsection*{FUNCTION}
When the listview is controlled with the keyboard and the user
presses RETURN, the value given here will be used as default
for MUIA\_Listview\_ClickColumn.

\subsubsection*{SEE ALSO}
MUIA\_Listview\_ClickColumn

\subsection[MUIA\_Listview\_DoubleClick]{MUIA\_Listview\_DoubleClick -- (V4) [I.G], BOOL}

\subsubsection*{FUNCTION}
This attribute is set to TRUE whenever the user
double clicks on an entry in the list.

\subsubsection*{SEE ALSO}
MUIA\_Listview\_SelectChange

\subsection[MUIA\_Listview\_Input]{MUIA\_Listview\_Input -- (V4) [I..], BOOL}

\subsubsection*{FUNCTION}
Setting this to FALSE will result in a read only
list view. Defaults to TRUE.

\subsubsection*{SEE ALSO}
MUIA\_Listview\_MultiSelect

\subsection[MUIA\_Listview\_List]{MUIA\_Listview\_List -- (V4) [I..], Object $\ast$}

\subsubsection*{FUNCTION}
Every listview needs a list object as child.
Specify it here.

As every other child, it will get disposes when
its parent object is disposed.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
ListviewObject,
   MUIA_Listview_Input, FALSE,
   MUIA_Listview_List , ListObject,
      ReadListFrame,
      MUIA_List_Format       , ",,",
      End,
   End;

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_Listview\_Input

\subsection[MUIA\_Listview\_MultiSelect]{MUIA\_Listview\_MultiSelect -- (V7) [I..], LONG}

\subsubsection*{SPECIAL INPUTS}
MUIV\_Listview\_MultiSelect\_None\\
MUIV\_Listview\_MultiSelect\_Default\\
MUIV\_Listview\_MultiSelect\_Shifted\\
MUIV\_Listview\_MultiSelect\_Always

\subsubsection*{FUNCTION}
Four possibilities exist for a listviews multi select
capabilities:

\begin{description}
\item[MUIV\_Listview\_MultiSelect\_None:]
The listview cannot multiselect at all.

\item[MUIV\_Listview\_MultiSelect\_Default:]
The multi select type (with or without shift) depends on
the users preferences setting.

\item[MUIV\_Listview\_MultiSelect\_Shifted:]
Overrides the users prefs, multi selecting only together
with shift key.

\item[MUIV\_Listview\_MultiSelect\_Always:]
Overrides the users prefs, multi selecting without shift key.
\end{description}

Please do {\bf not} override the users prefs unless you have a
good reason!

\subsubsection*{SEE ALSO}
MUIA\_List\_MultiTestHook

\subsection[MUIA\_Listview\_ScrollerPos]{MUIA\_Listview\_ScrollerPos -- (V10) [I..], BOOL}

\subsubsection*{SPECIAL INPUTS}
MUIV\_Listview\_ScrollerPos\_Default\\
MUIV\_Listview\_ScrollerPos\_Left\\
MUIV\_Listview\_ScrollerPos\_Right

\subsubsection*{FUNCTION}
Specifies the position of a listviews scrollbar.
Don't use this tag unless it's absolutely required!

\subsection[MUIA\_Listview\_SelectChange]{MUIA\_Listview\_SelectChange -- (V4) [..G], BOOL}

\subsubsection*{FUNCTION}
This attribute is set to TRUE whenever the selection state
of one or more items in the list is changing. You can
use this e.g. if you want to display the number of
selected items in a status line.

\subsubsection*{SEE ALSO}
MUIA\_List\_MultiSelect