Update of /cvsroot/freevo/freevo/Docs/plugin_writing
In directory sc8-pr-cvs1:/tmp/cvs-serv3250
Modified Files:
howto.sgml
Log Message:
some updates to the menu section
Index: howto.sgml
===================================================================
RCS file: /cvsroot/freevo/freevo/Docs/plugin_writing/howto.sgml,v
retrieving revision 1.4
retrieving revision 1.5
diff -C2 -d -r1.4 -r1.5
*** howto.sgml 1 Nov 2003 21:19:54 -0000 1.4
--- howto.sgml 10 Nov 2003 20:10:07 -0000 1.5
***************
*** 8,11 ****
--- 8,14 ----
<!ENTITY daemonaction SYSTEM "code/daemon_action.py" CDATA linespecific>
<!ENTITY item SYSTEM "code/item.py" CDATA linespecific>
+ <!ENTITY menuex1 SYSTEM "code/menu_Menu.py" CDATA linespecific>
+ <!ENTITY menuex2 SYSTEM "code/menu_Item.py" CDATA linespecific>
+ <!ENTITY menuex3 SYSTEM "code/menu_MenuItem.py" CDATA linespecific>
]>
***************
*** 133,142 ****
Menu is essentially a class wrapped around an array of choices. It has
several methods but the constructor is the most commonly used. It takes a title, then
an array of options, and then some optional parameters. The reload_func is the most
commonly used. The reload_func is used when you come back from executing an item. It's
only used when you want to show something other than the menu you started with when
you come back.
</para>
! <para><emphasis>Code Sample not written yet</emphasis></para>
</sect2>
<sect2>
<title>Item</title>
<para>Item is the base class for anything that appears in the Menu. Generally
you create a subclass of Item and then create an actions method to tell the menu what
to do when the item is clicked. The name property is what the Menu object uses to
display on the screen. You can then create other variables to hold important data
points in.</para>
! <para><emphasis>Code Sample not written yet</emphasis></para>
</sect2>
<sect2>
--- 136,147 ----
Menu is essentially a class wrapped around an array of choices. It has
several methods but the constructor is the most commonly used. It takes a title, then
an array of options, and then some optional parameters. The reload_func is the most
commonly used. The reload_func is used when you come back from executing an item. It's
only used when you want to show something other than the menu you started with when
you come back.
</para>
! <programlisting><inlinegraphic entityref="menuex1"></inlinegraphic>
! </programlisting>
</sect2>
<sect2>
<title>Item</title>
<para>Item is the base class for anything that appears in the Menu. Generally
you create a subclass of Item and then create an actions method to tell the menu what
to do when the item is clicked. The name property is what the Menu object uses to
display on the screen. You can then create other variables to hold important data
points in.</para>
! <programlisting><inlinegraphic entityref="menuex2"></inlinegraphic>
! </programlisting>
</sect2>
<sect2>
***************
*** 144,156 ****
<para>This is a convenience class it is useful in two different situations.
The first and most common is for creating Menus to display error conditions. The
second use is for when you only need a very simple item with a single easy
action.</para>
<para>To use MenuItem in the error condition case you call the constructor
with three parameters. The first parameter is what to display in the menu, the second
is the action to take when the item to select and the third is put the arg to the
action function. In this case you typically wrap the constructor call into an append
to your list of items to be given to menu.</para>
- <para><emphasis>Code Sample not written yet</emphasis></para>
<para>To use MenuItem as a simple Item and not bother with creating your own
sub item class, you again call the constructor with the set of three parameters. The
first parameter is what to display in the menu, the second is the action to take when
the item to select and the third is put the arg to the action function. But typically
you save a reference to this item and set a few additional parameters manually.</para>
! <para><emphasis>Code Sample not written yet</emphasis></para>
</sect2>
<sect2>
<title>MenuWidget</title>
<para>MenuWidget or menuw as it is often labelled in the code. Is a handy
utility class where most of the menu magic happens. It has most of the default utility
actions for menus as well as the methods to manage the menu stack.</para>
! <para><emphasis>List of common menu actions not written yet</emphasis></para>
! <para><emphasis>List of menu stack actions not written yet</emphasis></para>
<para><emphasis>Code Sample not written yet</emphasis></para>
</sect2>
--- 149,167 ----
<para>This is a convenience class it is useful in two different situations.
The first and most common is for creating Menus to display error conditions. The
second use is for when you only need a very simple item with a single easy
action.</para>
<para>To use MenuItem in the error condition case you call the constructor
with three parameters. The first parameter is what to display in the menu, the second
is the action to take when the item to select and the third is put the arg to the
action function. In this case you typically wrap the constructor call into an append
to your list of items to be given to menu.</para>
<para>To use MenuItem as a simple Item and not bother with creating your own
sub item class, you again call the constructor with the set of three parameters. The
first parameter is what to display in the menu, the second is the action to take when
the item to select and the third is put the arg to the action function. But typically
you save a reference to this item and set a few additional parameters manually.</para>
! <programlisting><inlinegraphic entityref="menuex3"></inlinegraphic>
! </programlisting>
</sect2>
<sect2>
<title>MenuWidget</title>
<para>MenuWidget or menuw as it is often labelled in the code. Is a handy
utility class where most of the menu magic happens. It has most of the default utility
actions for menus as well as the methods to manage the menu stack.</para>
! <para><emphasis>Common Menu Actions:</emphasis></para>
! <para>back_one_menu -- goes to the previous menu. Typically used after
deleteing the current menu. see cdbackup.py for an example.</para>
! <para>goto_main_menu -- jumps all the way back to the main menu.</para>
!
! <para><emphasis>List of menu stack actions:</emphasis></para>
! <para>pushmenu -- used after constructing a menu, then typically a call to
refresh to display the menu.</para>
! <para>refresh -- redraw the top item on the menu stack. It is usually called
after a pushmenu call.</para>
! <para>delete_menu -- remove the currently displayed menu.</para>
<para><emphasis>Code Sample not written yet</emphasis></para>
</sect2>
-------------------------------------------------------
This SF.Net email sponsored by: ApacheCon 2003,
16-19 November in Las Vegas. Learn firsthand the latest
developments in Apache, PHP, Perl, XML, Java, MySQL,
WebDAV, and more! http://www.apachecon.com/
_______________________________________________
Freevo-cvslog mailing list
[EMAIL PROTECTED]
https://lists.sourceforge.net/lists/listinfo/freevo-cvslog
