
# ImageControl.py::refactored from JJLee's ClientForm
# truenolejano@yahoo.com
# http://cheeseshop.python.org

# Copyright (C) 2004 by Richard Harris
# Released under the GNU General Public License
# (See the included COPYING file)

# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.

# This program is distributed in the hope that it will be useful, but
# WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
# General Public License for more details.

# You should have received a copy of the GNU General Public License
# with this program; if not, write to the Free Software Foundation,
# Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA

# Hack_History:
# 
# Copyright 2004 Richard Harris (mechanoid fork under GNU GPL)
# Copyright 2002-2003 John J. Lee <jjl@pobox.com> (BSD License)
# Copyright 1998-2000 Gisle Aas.
#

from SubmitControl import SubmitControl
from ScalarControl import ScalarControl

class ImageControl(SubmitControl):
	"""
	Covers:

	INPUT/IMAGE

	The value attribute of an ImageControl is always None.	Coordinates are
	specified using one of the HTMLForm.click* methods.

	"""
	def __init__(self, type, name, attrs):
		ScalarControl.__init__(self, type, name, attrs)
		self.__dict__["value"] = None

	def __setattr__(self, name, value):
		if name in ("value", "name", "type"):
			raise AttributeError("%s attribute is readonly" % name)
		else:
			self.__dict__[name] = value

	def pairs(self):
		clicked = self._clicked
		if self.disabled or not clicked:
			return []
		name = self.name
		if name is None: return []
		return [("%s.x" % name, str(clicked[0])),
				("%s.y" % name, str(clicked[1]))]
