qm.fields.DictionaryField

Package qm :: Module fields :: Class DictionaryField

[show private | hide private]

Type DictionaryField

object --+    
         |    
     Field --+
             |
            DictionaryField

A 'DictionaryField' maps keys to values.

Method Summary
	`__init__(self, key_field, value_field, **properties)` Construct a new 'DictionaryField'.
	`FormatValueAsHtml(self, server, content, style, name)`
	`GetHelp(self)` Generate help text about this field in structured text format.
	`GetKeyField(self)`
	`GetValueField(self)`
	`GetValueFromDomNode(self, node, attachment_store)` Return a value for this field represented by DOM 'node'.
	`MakeDomNodeForValue(self, value, document)` Generate a DOM element node for a value of this field.
	`ParseFormValue(self, request, name, attachment_stores)` Convert a value submitted from an HTML form.
	`ParseTextValue(self, value)` Parse a value represented as a string.
	`Validate(self, value)` Validate a field value.
Inherited from Field
	`__repr__(self)`
	`FormatValueAsText(self, value, columns)` Return a plain text rendering of a 'value' for this field.
	`GetBriefDescription(self)` Return a brief description of this field.
	`GetDefaultValue(self)` Return the default value for this field.
	`GetDescription(self)` Return a description of this field.
	`GetHtmlFormFieldName(self)` Return the form field name corresponding this field.
	`GetHtmlHelp(self, edit)` Generate help text about this field in HTML format.
	`GetName(self)` Return the name of the field.
	`GetSubfields(self)` Returns the sequence of subfields contained in this field.
	`GetTitle(self)` Return the user-friendly title of the field.
	`IsComputed(self)` Returns true if this field is computed automatically.
	`IsHidden(self)` Returns true if this 'Field' should be hidden from users.
	`IsReadOnly(self)` Returns true if this 'Field' cannot be modified by users.
	`SetName(self, name)` Set the name of the field.
Inherited from object
	`__delattr__(...)` x.__delattr__('name') <==> del x.name
	`__getattribute__(...)` x.__getattribute__('name') <==> x.name
	`__hash__(x)` x.__hash__() <==> hash(x)
	`__new__(T, S, ...)` T.__new__(S, ...) -> a new object with type S, a subtype of T
	`__reduce__(...)` helper for pickle
	`__reduce_ex__(...)` helper for pickle
	`__setattr__(...)` x.__setattr__('name', value) <==> x.name = value
	`__str__(x)` x.__str__() <==> str(x)

Class Variable Summary
Inherited from Field
`str`	`form_field_prefix` = `'_field_'`

Method Details

init(self, key_field, value_field, **properties)
(Constructor)

Construct a new 'DictionaryField'.

'key_field' -- The key field.

'value_field' -- The value field.

Overrides:: qm.fields.Field.__init__

GetHelp(self)

Generate help text about this field in structured text format.

Overrides:: qm.fields.Field.GetHelp (inherited documentation)

GetValueFromDomNode(self, node, attachment_store)

Return a value for this field represented by DOM 'node'.

This method does not validate the value for this particular instance; it only makes sure the node is well-formed, and returns a value of the correct Python type.

'node' -- The DOM node that is being evaluated.

'attachment_store' -- For attachments, the store that should be used.

If the 'node' is incorrectly formed, this method should raise an exception.

Overrides:: qm.fields.Field.GetValueFromDomNode (inherited documentation)

MakeDomNodeForValue(self, value, document)

Generate a DOM element node for a value of this field.

'value' -- The value to represent.

'document' -- The containing DOM document node.

Overrides:: qm.fields.Field.MakeDomNodeForValue (inherited documentation)

ParseFormValue(self, request, name, attachment_stores)

Convert a value submitted from an HTML form.

'request' -- The 'WebRequest' containing a value corresponding to this field.

'name' -- The name corresponding to this field in the 'request'.

'attachment_stores' -- A dictionary mapping 'AttachmentStore' ids (in the sense of Python's 'id' built-in) to the 'AttachmentStore's themselves.

returns -- A pair '(value, redisplay)'. 'value' is the value for this field, as indicated in 'request'. 'redisplay' is true if and only if the form should be redisplayed, rather than committed. If an error occurs, an exception is thrown.

Overrides:: qm.fields.Field.ParseFormValue (inherited documentation)

ParseTextValue(self, value)

Parse a value represented as a string.

'value' -- A string representing the value.

returns -- The corresponding field value. The value returned should be processed by 'Validate' to ensure that it is valid before it is returned.

Overrides:: qm.fields.Field.ParseTextValue (inherited documentation)

Validate(self, value)

Validate a field value.

For an acceptable type and value, return the representation of 'value' in the underlying field storage.

'value' -- A value to validate for this field.

returns -- If the 'value' is valid, returns 'value' or an equivalent "canonical" version of 'value'. (For example, this function may search a hash table and return an equivalent entry from the hash table.)

This function must raise an exception if the value is not valid. The string representation of the exception will be used as an error message in some situations.

Implementations of this method must be idempotent.

Overrides:: qm.fields.Field.Validate (inherited documentation)

Generated by Epydoc 2.1 on Thu Sep 27 15:48:59 2007

http://epydoc.sf.net