Added feature to the HTML manual to remember your preference to show or hide the...

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@53235 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775

diff --git a/docs/doxygen/htmlfooter.inc b/docs/doxygen/htmlfooter.inc
index 06365b741100609d761f04a9aff09af103b6aa49..b7fa53d103fa9be36122ddc08eb938f57aa2b3ec 100644 (file)
--- a/docs/doxygen/htmlfooter.inc
+++ b/docs/doxygen/htmlfooter.inc
@@ -16,6 +16,8 @@
 </tr>
 </table>
 
 </tr>
 </table>
 

+<script src="wxwidgets.js" type="text/javascript"></script>
+

 </body>
 </html>
 
 </body>
 </html>
 

diff --git a/docs/doxygen/regen.bat b/docs/doxygen/regen.bat
index d52d7e76311d77681525d54c3ccabd46764f1098..e3bfd0a54def325a1bed7b659519c0cf4cce7889 100644 (file)
--- a/docs/doxygen/regen.bat
+++ b/docs/doxygen/regen.bat
@@ -11,13 +11,14 @@ mkdir out\html\wxgtk 2>&1 >NUL
 mkdir out\html\wxmsw 2>&1 >NUL\r
 mkdir out\html\wxmac 2>&1 >NUL\r
 \r
 mkdir out\html\wxmsw 2>&1 >NUL\r
 mkdir out\html\wxmac 2>&1 >NUL\r
 \r

-REM this image is not automatically copied by Doxygen because it's not\r
-REM used in doxygen documentation but only in our html footer...\r
+REM These not automatically copied by Doxygen because it's not\r
+REM used in doxygen documentation, only in our html footer.\r

 copy images\powered-by-wxwidgets.png out\html 2>&1 >NUL\r
 copy images\*logo.png out\html 2>&1 >NUL\r
 copy images\wxgtk\*png out\html\wxgtk 2>&1 >NUL\r
 copy images\wxmsw\*png out\html\wxmsw 2>&1 >NUL\r
 copy images\wxmac\*png out\html\wxmac 2>&1 >NUL\r
 copy images\powered-by-wxwidgets.png out\html 2>&1 >NUL\r
 copy images\*logo.png out\html 2>&1 >NUL\r
 copy images\wxgtk\*png out\html\wxgtk 2>&1 >NUL\r
 copy images\wxmsw\*png out\html\wxmsw 2>&1 >NUL\r
 copy images\wxmac\*png out\html\wxmac 2>&1 >NUL\r

+copy wxwidgets.js out\html 2>&1 >NUL\r

 \r
 REM this CSS is automatically copied by Doxygen because it's\r
 REM included by our custom html header...\r
 \r
 REM this CSS is automatically copied by Doxygen because it's\r
 REM included by our custom html header...\r

diff --git a/docs/doxygen/regen.sh b/docs/doxygen/regen.sh
index 00b0dbf3545ec33e9a2b48965071699f43ab49a5..586b4fdc056f1d67bde9edcfb0a13954c1bae2ca 100755 (executable)
--- a/docs/doxygen/regen.sh
+++ b/docs/doxygen/regen.sh
@@ -25,14 +25,15 @@ cd $path
 mkdir -p out/html       # we need to copy files in this folder below
 mkdir -p out/html/wxmsw out/html/wxgtk out/html/wxmac
 
 mkdir -p out/html       # we need to copy files in this folder below
 mkdir -p out/html/wxmsw out/html/wxgtk out/html/wxmac
 

-# these images are not automatically copied by Doxygen because they're not
-# used in doxygen documentation but only in our html footer and by our
+# These are not automatically copied by Doxygen because they're not
+# used in doxygen documentation, only in our html footer and by our

 # custom aliases
 cp images/powered-by-wxwidgets.png out/html
 cp images/*logo.png out/html
 cp images/wxmsw/*png out/html/wxmsw
 cp images/wxmac/*png out/html/wxmac
 cp images/wxgtk/*png out/html/wxgtk
 # custom aliases
 cp images/powered-by-wxwidgets.png out/html
 cp images/*logo.png out/html
 cp images/wxmsw/*png out/html/wxmsw
 cp images/wxmac/*png out/html/wxmac
 cp images/wxgtk/*png out/html/wxgtk

+cp wxwidgets.js out/html

 
 # this CSS is not automatically copied by Doxygen because it's
 # included by our custom html header...
 
 # this CSS is not automatically copied by Doxygen because it's
 # included by our custom html header...

diff --git a/docs/doxygen/wxwidgets.js b/docs/doxygen/wxwidgets.js
new file mode 100644 (file)
index 0000000..b858660
--- /dev/null
+++ b/docs/doxygen/wxwidgets.js
@@ -0,0 +1,76 @@
+// from w3schools\r
+function getCookie(c_name)\r
+{\r
+  if (document.cookie.length>0)\r
+  {\r
+    c_start=document.cookie.indexOf(c_name + "=");\r
+    if (c_start!=-1)\r
+    { \r
+      c_start=c_start + c_name.length+1; \r
+      c_end=document.cookie.indexOf(";",c_start);\r
+      if (c_end==-1) c_end=document.cookie.length;\r
+      return unescape(document.cookie.substring(c_start,c_end));\r
+    } \r
+  }\r
+  return "";\r
+}\r
+// from w3schools\r
+function setCookie(c_name,value,expiredays)\r
+{\r
+  var exdate=new Date();\r
+  exdate.setDate(exdate.getDate()+expiredays);\r
+  document.cookie=c_name+ '=' +escape(value)+\r
+  ((expiredays==null) ? '' : ';expires='+exdate.toGMTString());\r
+}\r
+\r
+// Reimplementation of changeDisplayState\r
+function mychangeDisplayState( e )\r
+{\r
+  var num=this.id.replace(/[^[0-9]/g,'');\r
+  var button=this.firstChild;\r
+  var sectionDiv=document.getElementById('dynsection'+num);\r
+  if (sectionDiv.style.display=='none'||sectionDiv.style.display==''){\r
+    sectionDiv.style.display='block';\r
+    button.src='open.gif';\r
+  }else{\r
+    sectionDiv.style.display='none';\r
+    button.src='closed.gif';\r
+  }\r
+\r
+  setCookie( 'sectionDiv.style.display', sectionDiv.style.display );\r
+\r
+}\r
+\r
+window.onload = function myinitDynSections()\r
+{\r
+  var divs=document.getElementsByTagName('div');\r
+  var sectionCounter=1;\r
+  for(var i=0;i<divs.length-1;i++){\r
+    if(divs[i].className=='dynheader'&&divs[i+1].className=='dynsection'){\r
+      var header=divs[i];\r
+      var section=divs[i+1];\r
+      var button=header.firstChild;\r
+      if (button!='IMG'){\r
+        divs[i].insertBefore(document.createTextNode(' '),divs[i].firstChild);\r
+        button=document.createElement('img');\r
+        divs[i].insertBefore(button,divs[i].firstChild);\r
+      }\r
+      header.style.cursor='pointer';\r
+      header.onclick=mychangeDisplayState;\r
+      header.id='dynheader'+sectionCounter;\r
+      button.src='closed.gif';\r
+      section.id='dynsection'+sectionCounter;\r
+\r
+      var display = getCookie( 'sectionDiv.style.display' );\r
+      if ( display == '' ){\r
+        section.style.display='block'; // default\r
+      }else{\r
+        section.style.display=display;\r
+      }\r
+      setCookie( 'sectionDiv.style.display', section.style.display );\r
+\r
+      section.style.marginLeft='14px';\r
+      sectionCounter++;\r
+    }\r
+  }\r
+}\r