99. setObject

99. setObject
	Chapter 6. Commands written in the Java™ programming language

Parameter syntax:

[attribute_name|'-']? S [data_type|'-']? S [options|'-']? S [URL_or_file]?

data_type --> 'anyURI'|'hexBinary'|'base64Binary'|'XML'
              [ '[' file_extension [',' file_extension]* ']' ]?

options --> option [',' option]*

option --> 'gzip'|'embed'|'confirm'

Interactive command displaying a dialog box letting the user change the object (generally an image) represented by explicitly selected element.

attribute_name

This parameter specifies the name of the attribute containing the URL of the object or directly containing the object data encoded in 'hexBinary' or in 'base64Binary'.

If this parameter is absent (or is '-'), it is the selected element itself which contains the URL of the object or which directly contains the object data in 'hexBinary', 'base64Binary' or XML formats.

data_type (anyURI, hexBinary, base64Binary, XML)

Specifies how the object is to be ``stored'' in the element or in the attribute. Data type 'XML' is only allowed for elements (typically an svg:svg element).

If this parameter is absent (or is '-'), the data type is found using the grammar of the document. Of course, this cannot be guessed for documents conforming to a DTD (too weakly typed) and for invalid documents conforming to a W3C XML or RELAX NG schema.

A data type may optionally be followed by a list of one or more file extensions. See examples below. This list is used when a file chooser dialog is displayed to let the user specify which file to use.

gzip

Applies only to the 'hexBinary' and 'base64Binary' data types. If this option is specified, object data is compressed using gzip before being encoded in 'hexBinary' or in 'base64Binary'. Otherwise, data is not compressed before being encoded.

embed

Applies only to the 'anyURI' data type. If this option is specified, the object data is loaded from its source and converted to a "data:" URL.

confirm

Even if the URL_or_file parameter has been specified, display a file chooser dialog box to let the user confirm the choice of specified source file. This option is used when dropping an image file onto an image-viewport CSS content object in XMLmind XML Editor - Support of Cascading Style Sheets (W3C CSS).

URL_or_file

Specifies the source of the object. If this parameter is absent (or option confirm as been specified), a file chooser dialog box is displayed in order to let the user choose a source file (or confirm the choice of specified URL_or_file).

Examples:

setObject
setObject src anyURI
setObject fileref anyURI[png,jpg,jpeg,gif,svg,svgz]
setObject fileref - embed images/screenshot.png
setObject - hexBinary gzip
setObject location - - file://localhost/icons/apache_pb.gif
setObject - XML - C:\graphics\logo.svgz
setObject - XML[svg]


98. setReadOnly		100. showContentModel