\section{Cycle.mui}

Cycle class generates the well known cycle gadgets.
However, MUI cycle gadgets feature a (configurable)
popup menu to avoid clicking through many entries.

\subsection[MUIA\_Cycle\_Active]{MUIA\_Cycle\_Active -- (V4) [ISG], LONG}

SPECIAL INPUTS
MUIV\_Cycle\_Active\_Next
MUIV\_Cycle\_Active\_Prev

\subsubsection*{FUNCTION}
This attributes defines the number of the active
entry in the cycle gadgets. Valid range is from
0 for the first entry to NumEntries-1 for the last.

Setting MUIA\_Cycle\_Active causes the gadget to
be updated. On the other hand, when the user
plays around with the gadget, MUIA\_Cycle\_Active
will always reflects the current state.

Using MUIV\_Cycle\_Active\_Next and MUIV\_Cycle\_Active\_Prev
as attribute value during set causes the gadget to
cycle through its entries in the given direction.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
set(cycleobj,MUIA_Cycle_Active,3);

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_Cycle\_Entries

\subsection[MUIA\_Cycle\_Entries]{MUIA\_Cycle\_Entries -- (V4) [I..], STRPTR $\ast$}

\subsubsection*{FUNCTION}
Here you can define what entries shall be displayed
in your cycle gadget. You must supply a pointer to
a string array, containing one entry for each item
and terminated with a NULL.

Remember that cycle gadget entries may contain any
text formatting code such as bold, italic or
underlined characters.

Cycle gadgets set the preparse string for all entries
to ''$\backslash$33c'', this means that they will automatically
appear centered. Of course you can override this by
simply preceding your entries with own formatting code.

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
static const char *CYA_GroupTitleColor[] =
{
   "normal",
   "highlight",
   "3-dimensional",
   NULL
};

        CY_Title = CycleObject,
   MUIA_Cycle_Entries, CYA_GroupTitleColor,
   End;

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_Cycle\_Active, MUIA\_Text\_Contents