[mythtv-commits] Ticket #10434: Standardize the name of the text area use to display the window's title

[MythTV]

#10434: Standardize the name of the text area use to display the window's title
-------------------------------------------------+-------------------------
 Reporter:  Xavier Hervy <xavier.hervy@…>        |           Type:  Patch -
   Status:  new                                  |  Feature
Milestone:  unknown                              |       Priority:  minor
  Version:  Master Head                          |      Component:  MythTV
 Keywords:  theme mythui                         |  - General
                                                 |       Severity:  medium
                                                 |  Ticket locked:  0
-------------------------------------------------+-------------------------
 This is an attempt to standardize the name of the textarea used to display
 the title in a window.
 It does not mean that all the window will look the same, the freedom is
 left to the themer.

 I implemented 2 new methods in MythScreenType:

 * SetWindowTitle: set the title of the window. the title will be display
 in a textarea named "windowtitle" if defined in the window widget in XML.

 * SetAlternateTitleTextAreaName: specify the name of the textarea to be
 used if "windowtitle" have not be found. (The name is really bad). This
 method only allow a smooth conversion of the themes. It is not meant to be
 left in the code forever, it does just prevent breaking existing themes
 and will display a warning if the theme is not using the windowtitle.

 This patch also include a example of use for the Programs Search.

 The only purpose of the patch is to ease the creation of new theme. A
 consistant window's title could be created as follow:

 {{{
 <group name="basewindowtitle">
     <imagetype name="basetopbar">
         <position>0,0</position>
         <filename>backgrounds/topbar.png</filename>
     </imagetype>
     <textarea name="windowtitle">
         <area>20,4,650,36</area>
         <font>baselarge</font>
         <value></value>
     </textarea>
 </group>

 <window name="TitleDefinedInXML">
     <group name="titlebar" from="basewindowtitle" >
         <textarea name="windowtitle">
             <value>Title defined in XML</value>
         </textarea>
     </group>
 </window>

 <window name="TitleDefinedByProgram">
     <group name="titlebar" from="basewindowtitle" />
 </window>

 }}}

-- 
Ticket URL: <http://code.mythtv.org/trac/ticket/10434>
MythTV <http://code.mythtv.org/trac>
MythTV Media Center