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>
 
+<script src="wxwidgets.js" type="text/javascript"></script>
+
 </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
-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 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

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
 
-# 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
+cp wxwidgets.js out/html
 
 # 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