[Zope3-checkins] CVS: Zope3/src/zope/app/interfaces/browser - form.py:1.11

[Fred L. Drake, Jr.]

Update of /cvs-repository/Zope3/src/zope/app/interfaces/browser
In directory cvs.zope.org:/tmp/cvs-serv3076

Modified Files:
	form.py 
Log Message:
Document IVocabularyQueryView.setWidget(), update setName() and
performAction() docstrings.


=== Zope3/src/zope/app/interfaces/browser/form.py 1.10 => 1.11 ===
--- Zope3/src/zope/app/interfaces/browser/form.py:1.10	Thu May 22 18:49:45 2003
+++ Zope3/src/zope/app/interfaces/browser/form.py	Wed Jun 18 10:50:47 2003
@@ -146,9 +146,18 @@
         components separated by dots may be appended if multiple form
         fields are needed.
 
-        This will be called immediately after the IVocabularyQueryView
-        has been created; form values may be extracted as a result of
-        calling this method.
+        This method will be called after the IVocabularyQueryView has
+        been created and before performAction() is called.
+        """
+
+    def setWidget(widget):
+        """Set the widget using this query view.
+
+        This allows the query view to take advantage of rendering
+        helper methods made available by the widget.
+
+        This method will be called after the IVocabularyQueryView has
+        been created and before performAction() is called.
         """
 
     def performAction(value):
@@ -162,8 +171,8 @@
         Actions should only be performed if a submit button provided
         by the view was selected.
 
-        This method will be called after setName() and before
-        renderInput() or renderResults().
+        This method will be called after setName() and setWidget() and
+        before renderInput() or renderResults().
         """
 
     def renderInput():