[graphic-forms-cvs] r366 - in trunk: . docs/manual

[junrue at common-lisp.net]

Author: junrue
Date: Fri Oct 20 02:51:53 2006
New Revision: 366

Modified:
   trunk/NEWS.txt
   trunk/docs/manual/gfs-symbols.xml
   trunk/docs/manual/gfw-symbols.xml
Log:
 

Modified: trunk/NEWS.txt
==============================================================================
--- trunk/NEWS.txt	(original)
+++ trunk/NEWS.txt	Fri Oct 20 02:51:53 2006
@@ -13,7 +13,7 @@
 
   * GFW:EVENT-SCROLL function for handling low-level scrolling events
 
-  * GFW:SCROLLING-EVENT-DISPATCHER for automatic management of a scrollable
+  * GFW:SCROLLING-HELPER for automatic management of a scrollable
     child panel and window scrollbars (works in combination with
     GFW:HEAP-LAYOUT)
 

Modified: trunk/docs/manual/gfs-symbols.xml
==============================================================================
--- trunk/docs/manual/gfs-symbols.xml	(original)
+++ trunk/docs/manual/gfs-symbols.xml	Fri Oct 20 02:51:53 2006
@@ -632,6 +632,7 @@
     </description>
     <seealso>
       <reftopic>gfs:disposed-error</reftopic>
+      <reftopic>gfw:event-dispose</reftopic>
     </seealso>
   </generic-function>
 
@@ -667,7 +668,7 @@
     </description>
     <seealso>
       <reftopic>gfs:disposed-p</reftopic>
-      <reftopic>gfw:event-disposed</reftopic>
+      <reftopic>gfw:event-dispose</reftopic>
     </seealso>
   </generic-function>
 

Modified: trunk/docs/manual/gfw-symbols.xml
==============================================================================
--- trunk/docs/manual/gfw-symbols.xml	(original)
+++ trunk/docs/manual/gfw-symbols.xml	Fri Oct 20 02:51:53 2006
@@ -269,6 +269,37 @@
     </seealso>
   </generic-function>
 
+  <generic-function name="event-deactivate">
+    <syntax>
+      <arguments>
+        <argument name="event-dispatcher">
+          <description>
+            The <reftopic>gfw:event-dispatcher</reftopic> that will process
+            this event.
+          </description>
+        </argument>
+        <argument name="widget">
+          <description>
+            The <reftopic>gfw:widget</reftopic> being deactivated.
+          </description>
+        </argument>
+      </arguments>
+      <return>
+        <emphasis>undefined</emphasis>
+      </return>
+    </syntax>
+    <description>
+      Implement a method for this generic function to respond to the deactivation
+      of <arg1/>. This event is only received by top-level windows or dialogs,
+      and means that some other window or dialog has been activated.
+    </description>
+    <seealso>
+      <reftopic>gfw:event-source</reftopic>
+      <reftopic>gfw:top-level</reftopic>
+      <reftopic>gfw:dialog</reftopic>
+    </seealso>
+  </generic-function>
+
   <generic-function name="event-arm">
     <syntax>
       <arguments>
@@ -332,6 +363,131 @@
     </seealso>
   </generic-function>
 
+  <generic-function name="event-default-action">
+    <syntax>
+      <arguments>
+        <argument name="event-dispatcher">
+          <description>
+            The <reftopic>gfw:event-dispatcher</reftopic> that will process
+            this event.
+          </description>
+        </argument>
+        <argument name="widget">
+          <description>
+            The <reftopic>gfw:widget</reftopic> for which the default action
+            was invoked.
+          </description>
+        </argument>
+      </arguments>
+      <return>
+        <emphasis>undefined</emphasis>
+      </return>
+    </syntax>
+    <description>
+      Implement a method for this generic function to respond to a default action.
+      For example, a default action is invoked when the user double-clicks on a
+      <reftopic>gfw:list-box</reftopic>, or presses <ENTER> while the
+      keyboard focus is owned by a <reftopic>gfw:edit</reftopic> control.
+    </description>
+    <seealso>
+      <reftopic>gfw:event-source</reftopic>
+    </seealso>
+  </generic-function>
+
+  <generic-function name="event-dispose">
+    <syntax>
+      <arguments>
+        <argument name="event-dispatcher">
+          <description>
+            The <reftopic>gfw:event-dispatcher</reftopic> that will process
+            this event.
+          </description>
+        </argument>
+        <argument name="widget">
+          <description>
+            The <reftopic>gfw:widget</reftopic> being disposed.
+          </description>
+        </argument>
+      </arguments>
+      <return>
+        <emphasis>undefined</emphasis>
+      </return>
+    </syntax>
+    <description>
+      <para role="normal">
+        Implement a method for this generic function to respond to <arg1/>
+        being discarded via <reftopic>gfs:dispose</reftopic>. This event
+        function is called while the data model for widget is still valid.
+      </para>
+      <para role="normal">
+        Note: this function is not an interface to the Common Lisp
+        garbage collector.
+      </para>
+    </description>
+    <seealso>
+      <reftopic>gfw:event-source</reftopic>
+      <reftopic>gfs:disposed-error</reftopic>
+      <reftopic>gfs:disposed-p</reftopic>
+      <reftopic>gfs:native-object</reftopic>
+    </seealso>
+  </generic-function>
+
+  <generic-function name="event-focus-gain">
+    <syntax>
+      <arguments>
+        <argument name="event-dispatcher">
+          <description>
+            The <reftopic>gfw:event-dispatcher</reftopic> that will process
+            this event.
+          </description>
+        </argument>
+        <argument name="widget">
+          <description>
+            The <reftopic>gfw:widget</reftopic> gaining keyboard focus.
+          </description>
+        </argument>
+      </arguments>
+      <return>
+        <emphasis>undefined</emphasis>
+      </return>
+    </syntax>
+    <description>
+      Implement a method for this generic function to respond to <arg1/>
+      gaining the keyboard focus.
+    </description>
+    <seealso>
+      <reftopic>gfw:event-source</reftopic>
+    </seealso>
+  </generic-function>
+
+  <generic-function name="event-focus-loss">
+    <syntax>
+      <arguments>
+        <argument name="event-dispatcher">
+          <description>
+            The <reftopic>gfw:event-dispatcher</reftopic> that will process
+            this event.
+          </description>
+        </argument>
+        <argument name="widget">
+          <description>
+            The <reftopic>gfw:widget</reftopic> losing keyboard focus.
+          </description>
+        </argument>
+      </arguments>
+      <return>
+        <emphasis>undefined</emphasis>
+      </return>
+    </syntax>
+    <description>
+      Implement a method for this generic function to respond to <arg1/>
+      losing the keyboard focus.
+    </description>
+    <seealso>
+      <reftopic>gfw:event-source</reftopic>
+    </seealso>
+  </generic-function>
+
   <!-- ACCESSORS -->
 
 </package>