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

[Grégoire Weber]

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

Modified Files:
      Tag: cw-mail-branch
	form.py 
Log Message:
Synced up with HEAD

=== Zope3/src/zope/app/interfaces/browser/form.py 1.9 => 1.9.2.1 ===
--- Zope3/src/zope/app/interfaces/browser/form.py:1.9	Tue May 20 12:10:28 2003
+++ Zope3/src/zope/app/interfaces/browser/form.py	Sun Jun 22 10:23:12 2003
@@ -66,7 +66,7 @@
         The default implementation returns self.context.add(content),
         i.e. it delegates to the IAdding view.
         """
-    
+
     def nextURL():
         """Return the URL to be displayed after the add operation.
 
@@ -83,17 +83,6 @@
        default value and so on.
     """
 
-    def setPrefix(self, prefix):
-        """Set the form-variable name prefix used for the widget
-
-        The widget will define its own form variable names by
-        concatinating the prefix and the field name using a dot. For
-        example, with a prefix of "page" and a field name of "title",
-        a form name of "page.title" will be used. A widget may use
-        multiple form fields. If so, it should add distinguishing
-        suffixes to the prefix and field name.
-        """
-
     def __call__():
         """Render the widget
         """
@@ -112,20 +101,6 @@
           <div class="label">label</div><div class="field">field</div>
         """
 
-    # XXX The following two methods are being supported for backward
-    # compatability. They are deprecated and will be refactored away
-    # eventually.
-
-    def render(value):
-        """Renders this widget as HTML using property values in field.
-
-        The value if given will be used as the default value for the widget.
-        """
-
-    def renderHidden(value):
-        """Renders this widget as a hidden field.
-        """
-
 
 class IFormCollaborationView(Interface):
     """Views that collaborate to create a single form
@@ -171,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):
@@ -187,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():