[graphic-forms-cvs] r329 - in trunk/docs/manual: . gfg gfw - graphic-forms-cvs@common-lisp.net - mailman3.common-lisp.net

16 Oct 2006

Author: junrue
Date: Mon Oct 16 02:32:32 2006
New Revision: 329

Added:
   trunk/docs/manual/gfw/event-scroll.html
   trunk/docs/manual/gfw/event-session.html
   trunk/docs/manual/gfw/event-timer.html
Modified:
   trunk/docs/manual/Graphic-FormsProgrammingReference.wcp
   trunk/docs/manual/gfg/image-data.html
   trunk/docs/manual/gfw/timer.html
Log:
 

Modified: trunk/docs/manual/Graphic-FormsProgrammingReference.wcp
==============================================================================

--- trunk/docs/manual/Graphic-FormsProgrammingReference.wcp	(original)
+++ trunk/docs/manual/Graphic-FormsProgrammingReference.wcp	Mon Oct 16 02:32:32 2006
@@ -92,7 +92,7 @@
 DefaultTopic=Introduction.html
 
 [TOPICS]
-TitleList=139
+TitleList=142
 TitleList.Title.0=Legal Information
 TitleList.Level.0=0
 TitleList.Url.0=LegalInfo.html
@@ -161,7 +161,7 @@
 TitleList.Keywords.6=GFG`\graphic-forms.uitoolkit.graphics`\Graphics Package
 TitleList.ContextNumber.6=
 TitleList.ApplyTemp.6=0
-TitleList.Expanded.6=1
+TitleList.Expanded.6=0
 TitleList.Kind.6=0
 TitleList.Title.7=ascent
 TitleList.Level.7=2
@@ -618,7 +618,7 @@
 TitleList.Url.52=gfg\image-data.html
 TitleList.Icon.52=0
 TitleList.Status.52=0
-TitleList.Keywords.52=image-data
+TitleList.Keywords.52=image-data`\:data-plugin
 TitleList.ContextNumber.52=
 TitleList.ApplyTemp.52=0
 TitleList.Expanded.52=0
@@ -1161,7 +1161,7 @@
 TitleList.Keywords.106=GFW`\graphic-forms.uitoolkit.widgets`\Widgets Package
 TitleList.ContextNumber.106=
 TitleList.ApplyTemp.106=0
-TitleList.Expanded.106=0
+TitleList.Expanded.106=1
 TitleList.Kind.106=0
 TitleList.Title.107=default-message-filter
 TitleList.Level.107=2
@@ -1303,184 +1303,214 @@
 TitleList.ApplyTemp.120=0
 TitleList.Expanded.120=0
 TitleList.Kind.120=0
-TitleList.Title.121=event-select
+TitleList.Title.121=event-scroll
 TitleList.Level.121=2
-TitleList.Url.121=gfw\event-select.html
+TitleList.Url.121=gfw\event-scroll.html
 TitleList.Icon.121=0
 TitleList.Status.121=0
-TitleList.Keywords.121=event-select
+TitleList.Keywords.121=event-scroll`\:horizontal/event-scroll`\:vertical/event-scroll`\:end`\:page-back`\:page-forward`\:step-back`\:step-forward`\:thumb-position`\:thumb-track
 TitleList.ContextNumber.121=
 TitleList.ApplyTemp.121=0
 TitleList.Expanded.121=0
 TitleList.Kind.121=0
-TitleList.Title.122=event-source
+TitleList.Title.122=event-select
 TitleList.Level.122=2
-TitleList.Url.122=gfw\event-source.html
+TitleList.Url.122=gfw\event-select.html
 TitleList.Icon.122=0
 TitleList.Status.122=0
-TitleList.Keywords.122=event-source
+TitleList.Keywords.122=event-select
 TitleList.ContextNumber.122=
 TitleList.ApplyTemp.122=0
 TitleList.Expanded.122=0
 TitleList.Kind.122=0
-TitleList.Title.123=flow-layout
+TitleList.Title.123=event-session
 TitleList.Level.123=2
-TitleList.Url.123=gfw\flow-layout.html
+TitleList.Url.123=gfw\event-session.html
 TitleList.Icon.123=0
 TitleList.Status.123=0
-TitleList.Keywords.123=flow-layout`\:style/flow-layout`\
+TitleList.Keywords.123=event-session`\:query`\:end`\:logoff`\:replacing-file`\:shutdown`\
 TitleList.ContextNumber.123=
 TitleList.ApplyTemp.123=0
 TitleList.Expanded.123=0
 TitleList.Kind.123=0
-TitleList.Title.124=item
+TitleList.Title.124=event-source
 TitleList.Level.124=2
-TitleList.Url.124=gfw\item.html
+TitleList.Url.124=gfw\event-source.html
 TitleList.Icon.124=0
 TitleList.Status.124=0
-TitleList.Keywords.124=item`\:callback/item`\:item-id
+TitleList.Keywords.124=event-source
 TitleList.ContextNumber.124=
 TitleList.ApplyTemp.124=0
 TitleList.Expanded.124=0
 TitleList.Kind.124=0
-TitleList.Title.125=item-manager
+TitleList.Title.125=event-timer
 TitleList.Level.125=2
-TitleList.Url.125=gfw\item-manager.html
+TitleList.Url.125=gfw\event-timer.html
 TitleList.Icon.125=0
 TitleList.Status.125=0
-TitleList.Keywords.125=item-manager`\:image-provider`\:text-provider`\:sort-predicate
+TitleList.Keywords.125=event-timer
 TitleList.ContextNumber.125=
 TitleList.ApplyTemp.125=0
 TitleList.Expanded.125=0
 TitleList.Kind.125=0
-TitleList.Title.126=heap-layout
+TitleList.Title.126=flow-layout
 TitleList.Level.126=2
-TitleList.Url.126=gfw\heap-layout.html
+TitleList.Url.126=gfw\flow-layout.html
 TitleList.Icon.126=0
 TitleList.Status.126=0
-TitleList.Keywords.126=heap-layout`\:top-child
+TitleList.Keywords.126=flow-layout`\:spacing`\:style/flow-layout`\:horizontal/flow-layout`\:vertical/flow-layout`\:normalize`\:wrap`\
 TitleList.ContextNumber.126=
 TitleList.ApplyTemp.126=0
 TitleList.Expanded.126=0
 TitleList.Kind.126=0
-TitleList.Title.127=layout-managed
+TitleList.Title.127=item
 TitleList.Level.127=2
-TitleList.Url.127=gfw\layout-managed.html
+TitleList.Url.127=gfw\item.html
 TitleList.Icon.127=0
 TitleList.Status.127=0
-TitleList.Keywords.127=layout-managed`\:layout`\
+TitleList.Keywords.127=item`\:callback/item`\:item-id
 TitleList.ContextNumber.127=
 TitleList.ApplyTemp.127=0
 TitleList.Expanded.127=0
 TitleList.Kind.127=0
-TitleList.Title.128=layout-manager
+TitleList.Title.128=item-manager
 TitleList.Level.128=2
-TitleList.Url.128=gfw\layout-manager.html
+TitleList.Url.128=gfw\item-manager.html
 TitleList.Icon.128=0
 TitleList.Status.128=0
-TitleList.Keywords.128=layout-manager`\:bottom-margin`\:horizontal-margins`\:left-margin`\:margins`\:right-margin`\:style/layout-manager`\:top-margin`\:vertical-margins`\
+TitleList.Keywords.128=item-manager`\:image-provider`\:text-provider`\:sort-predicate
 TitleList.ContextNumber.128=
 TitleList.ApplyTemp.128=0
 TitleList.Expanded.128=0
 TitleList.Kind.128=0
-TitleList.Title.129=list-item
+TitleList.Title.129=heap-layout
 TitleList.Level.129=2
-TitleList.Url.129=gfw\list-item.html
+TitleList.Url.129=gfw\heap-layout.html
 TitleList.Icon.129=0
 TitleList.Status.129=0
-TitleList.Keywords.129=list-item
+TitleList.Keywords.129=heap-layout`\:top-child
 TitleList.ContextNumber.129=
 TitleList.ApplyTemp.129=0
 TitleList.Expanded.129=0
 TitleList.Kind.129=0
-TitleList.Title.130=message-loop
+TitleList.Title.130=layout-managed
 TitleList.Level.130=2
-TitleList.Url.130=gfw\message-loop.html
+TitleList.Url.130=gfw\layout-managed.html
 TitleList.Icon.130=0
 TitleList.Status.130=0
-TitleList.Keywords.130=message-loop
+TitleList.Keywords.130=layout-managed`\:layout`\
 TitleList.ContextNumber.130=
 TitleList.ApplyTemp.130=0
 TitleList.Expanded.130=0
 TitleList.Kind.130=0
-TitleList.Title.131=obtain-event-time
+TitleList.Title.131=layout-manager
 TitleList.Level.131=2
-TitleList.Url.131=gfw\obtain-event-time.html
+TitleList.Url.131=gfw\layout-manager.html
 TitleList.Icon.131=0
 TitleList.Status.131=0
-TitleList.Keywords.131=obtain-event-time
+TitleList.Keywords.131=layout-manager`\:bottom-margin`\:horizontal-margins`\:left-margin`\:margins`\:right-margin`\:style/layout-manager`\:top-margin`\:vertical-margins`\
 TitleList.ContextNumber.131=
 TitleList.ApplyTemp.131=0
 TitleList.Expanded.131=0
 TitleList.Kind.131=0
-TitleList.Title.132=timer
+TitleList.Title.132=list-item
 TitleList.Level.132=2
-TitleList.Url.132=gfw\timer.html
+TitleList.Url.132=gfw\list-item.html
 TitleList.Icon.132=0
 TitleList.Status.132=0
-TitleList.Keywords.132=timer`\:delay`\:initial-delay`\
+TitleList.Keywords.132=list-item
 TitleList.ContextNumber.132=
 TitleList.ApplyTemp.132=0
 TitleList.Expanded.132=0
 TitleList.Kind.132=0
-TitleList.Title.133=with-graphics-context
+TitleList.Title.133=message-loop
 TitleList.Level.133=2
-TitleList.Url.133=gfw\with-graphics-context.html
+TitleList.Url.133=gfw\message-loop.html
 TitleList.Icon.133=0
 TitleList.Status.133=0
-TitleList.Keywords.133=with-graphics-context
+TitleList.Keywords.133=message-loop
 TitleList.ContextNumber.133=
 TitleList.ApplyTemp.133=0
 TitleList.Expanded.133=0
 TitleList.Kind.133=0
-TitleList.Title.134=Miscellaneous Topics
-TitleList.Level.134=0
-TitleList.Url.134=MiscellaneousTopics.html
+TitleList.Title.134=obtain-event-time
+TitleList.Level.134=2
+TitleList.Url.134=gfw\obtain-event-time.html
 TitleList.Icon.134=0
 TitleList.Status.134=0
-TitleList.Keywords.134=Miscellaneous Topics
+TitleList.Keywords.134=obtain-event-time
 TitleList.ContextNumber.134=
 TitleList.ApplyTemp.134=0
 TitleList.Expanded.134=0
 TitleList.Kind.134=0
-TitleList.Title.135=Image Data Plugins
-TitleList.Level.135=1
-TitleList.Url.135=ImageDataPlugins.html
+TitleList.Title.135=timer
+TitleList.Level.135=2
+TitleList.Url.135=gfw\timer.html
 TitleList.Icon.135=0
 TitleList.Status.135=0
-TitleList.Keywords.135=Image Data Plugins
+TitleList.Keywords.135=timer`\:delay`\:initial-delay`\
 TitleList.ContextNumber.135=
 TitleList.ApplyTemp.135=0
 TitleList.Expanded.135=0
 TitleList.Kind.135=0
-TitleList.Title.136=Terminology Conventions
-TitleList.Level.136=0
-TitleList.Url.136=TerminologyConventions.html
+TitleList.Title.136=with-graphics-context
+TitleList.Level.136=2
+TitleList.Url.136=gfw\with-graphics-context.html
 TitleList.Icon.136=0
 TitleList.Status.136=0
-TitleList.Keywords.136=terminology`\conventions
+TitleList.Keywords.136=with-graphics-context
 TitleList.ContextNumber.136=
 TitleList.ApplyTemp.136=0
 TitleList.Expanded.136=0
 TitleList.Kind.136=0
-TitleList.Title.137=Glossary
+TitleList.Title.137=Miscellaneous Topics
 TitleList.Level.137=0
-TitleList.Url.137=Glossary.html
+TitleList.Url.137=MiscellaneousTopics.html
 TitleList.Icon.137=0
 TitleList.Status.137=0
-TitleList.Keywords.137=Glossary
+TitleList.Keywords.137=Miscellaneous Topics
 TitleList.ContextNumber.137=
 TitleList.ApplyTemp.137=0
 TitleList.Expanded.137=0
 TitleList.Kind.137=0
-TitleList.Title.138=Footnotes
-TitleList.Level.138=0
-TitleList.Url.138=Footnotes.html
+TitleList.Title.138=Image Data Plugins
+TitleList.Level.138=1
+TitleList.Url.138=ImageDataPlugins.html
 TitleList.Icon.138=0
 TitleList.Status.138=0
-TitleList.Keywords.138=
+TitleList.Keywords.138=Image Data Plugins
 TitleList.ContextNumber.138=
 TitleList.ApplyTemp.138=0
 TitleList.Expanded.138=0
-TitleList.Kind.138=1
+TitleList.Kind.138=0
+TitleList.Title.139=Terminology Conventions
+TitleList.Level.139=0
+TitleList.Url.139=TerminologyConventions.html
+TitleList.Icon.139=0
+TitleList.Status.139=0
+TitleList.Keywords.139=terminology`\conventions
+TitleList.ContextNumber.139=
+TitleList.ApplyTemp.139=0
+TitleList.Expanded.139=0
+TitleList.Kind.139=0
+TitleList.Title.140=Glossary
+TitleList.Level.140=0
+TitleList.Url.140=Glossary.html
+TitleList.Icon.140=0
+TitleList.Status.140=0
+TitleList.Keywords.140=Glossary
+TitleList.ContextNumber.140=
+TitleList.ApplyTemp.140=0
+TitleList.Expanded.140=0
+TitleList.Kind.140=0
+TitleList.Title.141=Footnotes
+TitleList.Level.141=0
+TitleList.Url.141=Footnotes.html
+TitleList.Icon.141=0
+TitleList.Status.141=0
+TitleList.Keywords.141=
+TitleList.ContextNumber.141=
+TitleList.ApplyTemp.141=0
+TitleList.Expanded.141=0
+TitleList.Kind.141=1
 

Modified: trunk/docs/manual/gfg/image-data.html
==============================================================================
--- trunk/docs/manual/gfg/image-data.html	(original)
+++ trunk/docs/manual/gfg/image-data.html	Mon Oct 16 02:32:32 2006
@@ -73,13 +73,13 @@
      attributes is delegated to a plugin 
 object.</FONT></FONT><FONT face=Arial size=2><EM></P></EM></FONT>
 <H4><FONT face=Arial>
-<H4><FONT face=Arial>slots</FONT></H4><FONT face=Arial size=2><EM>
+<H4><FONT face=Arial>initargs</FONT></H4><FONT face=Arial size=2><EM>
 <P dir=ltr style="MARGIN-RIGHT: 0px">
 <TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" borderColor=#ffffff 
 cellSpacing=0 cellPadding=2 width="100%" border=1>
   
   <TR>
-    <TD width="20%"><EM><FONT size=2>data-plugin</FONT></EM></TD>
+    <TD width="20%"><FONT size=2>:data-plugin</FONT></TD>
     <TD><FONT size=2>An instance of <A 
       href="image-data-plugin.html">image-data-plugin</A>.</FONT></TD></TR></TABLE></P></EM></FONT>see also</FONT></H4>
 <P><FONT face=Arial size=2></FONT><FONT face=Arial size=2><FONT 

Added: trunk/docs/manual/gfw/event-scroll.html
==============================================================================
--- (empty file)
+++ trunk/docs/manual/gfw/event-scroll.html	Mon Oct 16 02:32:32 2006
@@ -0,0 +1,140 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<title>event-scroll</title>
+<meta name="GENERATOR" content="WinCHM">
+<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
+
+</head>
+
+<body><FONT face=Arial>
+<H4>
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" 
+borderColor=#ffffff cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="60%"><STRONG>event-scroll</STRONG></TD>
+    <TD>
+      <P><FONT size=2>[Generic Function]</FONT> </P></TD></TR></TABLE>
+<HR></H4>
+<P></FONT><FONT face=Arial><STRONG>syntax</STRONG></FONT></P>
+  <P dir=ltr style="MARGIN-RIGHT: 0px"><FONT 
+face=Arial size=2><FONT face=Arial size=2>(gfw:event-scroll <A 
+href="event-dispatcher.html"><EM>event-dispatcher</EM></A><EM> </EM><EM>widget axis detail</EM>)<EM> </EM></P>
+<H4>arguments 
+<P>
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" borderColor=#ffffff 
+cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="20%"><EM><FONT size=2>event-dispatcher</FONT></EM></TD>
+    <TD><FONT size=2>The <A href="event-dispatcher.html" >event-dispatcher</A> that will 
+      process the this event.</FONT></TD></TR>
+  <TR>
+    <TD width="20%"><FONT size=2><EM>widget</EM></FONT></TD>
+    <TD><FONT size=2>  
+       The widget   
+      receiving the scroll 
+event.</FONT></TD></TR>
+  <TR>
+    <TD width="20%"><FONT size=2><EM>axis</EM></FONT></TD>
+    <TD><FONT size=2>One of the following keywords describing the scroll 
+      orientation:<BR>
+      <TABLE style="BORDER-COLLAPSE: collapse" borderColor=#ffffff cellSpacing=0 
+      cellPadding=2 width="100%" border=1>
+        
+        <TR>
+          <TD width="30%"><FONT size=2>:horizontal</FONT></TD>
+          <TD><FONT size=2>        
+                       
+                    Scrolling is occurring on the 
+            horizontal axis.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT size=2>:vertical</FONT></TD>
+          <TD><FONT size=2>         
+                  Scrolling is occurring on the 
+            vertical axis.</FONT></TD></TR></TABLE></FONT></TD></TR>
+  <TR>
+    <TD width="20%"><FONT size=2><EM>detail</EM></FONT></TD>
+    <TD><FONT 
+size=2>  
+      One of the following keywords describing what scrolling action should take place:<BR>
+      <TABLE style="BORDER-COLLAPSE: collapse" borderColor=#ffffff cellSpacing=0 
+      cellPadding=2 width="100%" border=1>
+        
+        <TR>
+          <TD width="30%"><FONT size=2>:end</FONT></TD>
+          <TD><FONT size=2>Move the 
+            viewport such that the bottom or right-most content is revealed.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT size=2>:page-back</FONT></TD>
+          <TD><FONT size=2>Move the 
+            viewport backwards by an amount equal to the viewport's height or 
+            width, or the amount remaining between the current viewport origin and the model 
+            origin, whichever is smaller.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT size=2>:page-forward</FONT></TD>
+          <TD><FONT size=2>Move the 
+            viewport forward by an amount equal to the viewport's height or 
+            width, or the amount remaining between the current viewport origin 
+            and the model extent, whichever is 
+        smaller.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT size=2>:start</FONT></TD>
+          <TD><FONT size=2>Move the viewport such that the top or left-most 
+            model content is revealed.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT 
+          size=2>:step-back</FONT></TD>
+          <TD><FONT size=2>Move the viewport backwards by 
+            an application-defined amount, or the amount remaining between 
+            the current viewport origin and the model origin, whichever is 
+            smaller.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT 
+            size=2>:step-forward</FONT></TD>
+          <TD><FONT size=2>Move the viewport forward 
+            by an application-defined amount, or the amount remaining 
+            between the current viewport origin and the model extent, whichever 
+            is smaller.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT 
+            size=2>:thumb-position</FONT></TD>
+          <TD><FONT size=2>Move the viewport to an 
+            absolute position.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT 
+          size=2>:thumb-track</FONT></TD>
+          <TD><FONT size=2>The user is adjusting the 
+            viewport origin continuously, as when dragging the scrollbar 
+            thumb.</FONT></TD></TR></TABLE></FONT></TD></TR></TABLE></P>description</H4><FONT face=Arial size=2><FONT face=Arial size=2>
+<P>          
+              
+             
+              
+  Implement this method to handle scrolling notifications.</P>
+<P dir=ltr style="MARGIN-RIGHT: 0px">               
+            
+              
+              
+                
+            
+              
+  
+         
+       </FONT>
+<HR>
+
+<P></P>
+
+<P dir=ltr style="MARGIN-RIGHT: 0px"> </P>
+<P dir=ltr style="MARGIN-RIGHT: 0px">
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" borderColor=#ffffff 
+cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="60%">  </TD>
+    <TD>
+      <P><FONT size=1>Copyright � 2006, Jack D. Unrue</FONT> 
+</P></TD></TR></TABLE></P></FONT></FONT></FONT></body>
+</html>

Added: trunk/docs/manual/gfw/event-session.html
==============================================================================
--- (empty file)
+++ trunk/docs/manual/gfw/event-session.html	Mon Oct 16 02:32:32 2006
@@ -0,0 +1,114 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<title>event-session</title>
+<meta name="GENERATOR" content="WinCHM">
+<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
+
+</head>
+
+<body><FONT face=Arial>
+<H4>
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" 
+borderColor=#ffffff cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="60%"><STRONG>event-session</STRONG></TD>
+    <TD>
+      <P><FONT size=2>[Generic Function]</FONT> </P></TD></TR></TABLE>
+<HR></H4>
+<P></FONT><FONT face=Arial><STRONG>syntax</STRONG></FONT></P>
+  <P dir=ltr style="MARGIN-RIGHT: 0px"><FONT 
+face=Arial size=2><FONT face=Arial size=2>(gfw:event-session <A 
+href="event-dispatcher.html"><EM>event-dispatcher</EM></A><EM> </EM><EM>window</EM> <EM>phase reason</EM>)<EM> </EM></P>
+<H4>arguments 
+<P>
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" borderColor=#ffffff 
+cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="20%"><EM><FONT size=2>event-dispatcher</FONT></EM></TD>
+    <TD><FONT size=2>The <A href="event-dispatcher.html" >event-dispatcher</A> that will 
+      process the this event.</FONT></TD></TR>
+  <TR>
+    <TD width="20%"><FONT size=2><EM>window</EM></FONT></TD>
+    <TD><FONT size=2>The top-level 
+      window to which   
+      this event was 
+delivered.</FONT></TD></TR>
+  <TR>
+    <TD width="20%"><FONT size=2><EM>phase</EM></FONT></TD>
+    <TD><FONT size=2>Identifies which of the two phases this event 
+      represents:<BR>
+      <TABLE style="BORDER-COLLAPSE: collapse" borderColor=#ffffff cellSpacing=0 
+      cellPadding=2 width="100%" border=1>
+        
+        <TR>
+          <TD width="30%"><FONT size=2>:query</FONT></TD>
+          <TD><FONT size=2>Means that the system is querying the application 
+            for permission to proceed with shutdown. Return NIL from this method 
+            if the application has a reason to veto the process, or any non-NIL 
+            value otherwise.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT size=2>:end</FONT></TD>
+          <TD><FONT size=2>This represents the second phase and means that the 
+            system is going down, therefore this event is an opportunity for 
+            graceful cleanup.</FONT></TD></TR></TABLE></FONT></TD></TR>
+  <TR>
+    <TD width="20%"><FONT size=2><EM>reason</EM></FONT></TD>
+    <TD><FONT 
+size=2>Provides more 
+      detail to help the application decide on the proper course of action:<BR>
+      <TABLE style="BORDER-COLLAPSE: collapse" borderColor=#ffffff cellSpacing=0 
+      cellPadding=2 width="100%" border=1>
+        
+        <TR>
+          <TD width="30%"><FONT size=2>:logoff</FONT></TD>
+          <TD><FONT size=2>The user is logging off.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT size=2>:replacing-file</FONT></TD>
+          <TD><FONT size=2>The application must exit because a file it is 
+            using is being replaced.</FONT></TD></TR>
+        <TR>
+          <TD width="30%"><FONT size=2>:shutdown</FONT></TD>
+          <TD><FONT size=2>The system is shutting down or 
+        restarting.</FONT></TD></TR></TABLE></FONT></TD></TR></TABLE></P>description</H4><FONT face=Arial size=2><FONT face=Arial size=2>
+<P>Implement this method to participate in the system's session shutdown 
+protocol. When the user chooses to end the session (by logging out or by 
+shutting down), or if an application calls one of the Win32 shutdown functions, 
+every application is given a veto option. This event function will be called at 
+least once for each top-level window in the application.</P>
+<P>The MSDN documentation makes the following recommendations for handling this 
+event: </P>
+<UL>
+  <LI>Whenever possible, applications should respect the user's intentions by 
+  allowing the session to end. </LI>
+  <LI>In the case of a critical operation, provide a dialog or other feedback 
+  with information for the user as to consequences if the application is 
+  interrupted at this time. </LI>
+  <LI>Respond to the :query event as quickly as possible, leaving time-consuming 
+  cleanup to be done in the session :end event. </LI></UL>
+<P dir=ltr style="MARGIN-RIGHT: 0px">               
+            
+              
+              
+                
+            
+              
+  
+         
+       </FONT>
+<HR>
+</P>
+
+<P dir=ltr style="MARGIN-RIGHT: 0px"> </P>
+<P dir=ltr style="MARGIN-RIGHT: 0px">
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" borderColor=#ffffff 
+cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="60%">  </TD>
+    <TD>
+      <P><FONT size=1>Copyright � 2006, Jack D. Unrue</FONT> 
+</P></TD></TR></TABLE></P></FONT></FONT></FONT></body>
+</html>

Added: trunk/docs/manual/gfw/event-timer.html
==============================================================================
--- (empty file)
+++ trunk/docs/manual/gfw/event-timer.html	Mon Oct 16 02:32:32 2006
@@ -0,0 +1,62 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+<title>event-timer</title>
+<meta name="GENERATOR" content="WinCHM">
+<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
+
+</head>
+
+<body><FONT face=Arial>
+<H4>
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" 
+borderColor=#ffffff cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="60%"><STRONG>event-timer</STRONG></TD>
+    <TD>
+      <P><FONT size=2>[Generic Function]</FONT> </P></TD></TR></TABLE>
+<HR></H4>
+<P></FONT><FONT face=Arial><STRONG>syntax</STRONG></FONT></P>
+  <P dir=ltr style="MARGIN-RIGHT: 0px"><FONT 
+face=Arial size=2><FONT face=Arial size=2>(gfw:event-timer <A 
+href="event-dispatcher.html"><EM>event-dispatcher</EM></A><EM> </EM> <A 
+href="timer.html"><EM>timer</EM></A>)<EM> </EM></P>
+<H4><FONT face=Arial>arguments 
+<P>
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" borderColor=#ffffff 
+cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="20%"><EM><FONT size=2>event-dispatcher</FONT></EM></TD>
+    <TD><FONT size=2>The <A href="event-dispatcher.html" >event-dispatcher</A> that will 
+      process the this event.</FONT></TD></TR>
+  <TR>
+    <TD width="20%"><FONT size=2><EM>timer</EM></FONT></TD>
+    <TD><FONT size=2>The <A 
+      href="timer.html">timer</A>   
+      that generated the 
+event.</FONT></TD></TR></TABLE></P>description</FONT></H4><FONT face=Arial size=2>
+<P dir=ltr style="MARGIN-RIGHT: 0px"><FONT face=Arial size=2>               
+            
+              
+              
+                
+            
+            Implement a 
+ method 
+for this generic function to handle timer   
+       notifications.</FONT></P>
+<HR>
+
+<P dir=ltr style="MARGIN-RIGHT: 0px"> </P>
+<P dir=ltr style="MARGIN-RIGHT: 0px">
+<TABLE style="WIDTH: 100%; BORDER-COLLAPSE: collapse" borderColor=#ffffff 
+cellSpacing=0 cellPadding=2 width="100%" border=1>
+  
+  <TR>
+    <TD width="60%">  </TD>
+    <TD>
+      <P><FONT size=1>Copyright � 2006, Jack D. Unrue</FONT> 
+</P></TD></TR></TABLE></P></FONT></FONT></FONT></body>
+</html>

Modified: trunk/docs/manual/gfw/timer.html
==============================================================================
--- trunk/docs/manual/gfw/timer.html	(original)
+++ trunk/docs/manual/gfw/timer.html	Mon Oct 16 02:32:32 2006
@@ -41,8 +41,10 @@
            
     
              
-           A timer is a 
-non-windowed object that generates events at a regular (adjustable)  
+            A timer is a 
+non-windowed object that generates events at a regular (adjustable) 
+frequency. Applications handle timer events by implementing the <A 
+href="event-timer.html">event-timer</A>  
     
              
            
@@ -52,7 +54,18 @@
            
     
              
-           frequency. Applications  
+               
+         
+    
+             
+           
+          
+          
+       
+           
+    
+             
+              
     
              
            
@@ -64,7 +77,7 @@
              
            
           
-   handle timer events  
+       
     
              
            
@@ -76,7 +89,7 @@
              
           
              
-     by implementing the timer-event generic 
+         generic 
 function. 

    

[graphic-forms-cvs] r329 - in trunk/docs/manual: . gfg gfw

junrue＠common-lisp.net

tags

participants (1)