Icons: UpdateIconUpdates an existing Icon

Usage Notes

The Category and Variation parameters are meant to be used together to describe an Icon. The Category can (and should) be duplicated, whereas the Variation should be unique to the category.

Here are some examples:

CategoryVariation
Ambulance
BlackberryBlack
BlackberryWhite
iPhoneBlack
iPhoneWhite
UserAdmin (Male)
UserAdmin (Female)

The Usage parameter takes a comma deliminated list of target types. The list should be in all lower-case, and should not contain white-space.

Here are the valid target types:

Here are a few example Usage strings:

The LabelAlign parameter takes a two-word space separated value containing first the horizontal attachment, then the vertical attachment.

Here are a few example LabelAlign strings:

Example of Returned Data

<UpdateIcon Success="?" Message="" />

Test Method

ParameterValueTypeUsage
IconIDint32Unique icon identifier
AccountIDint32Unique account identifier
CategorystringA one or two word description of the icon
VariationstringA one or two word description of the number, colour, or shape
UsagestringSee Usage Notes.
Comma deliminated string of target types
Notesstring 
ImageSrcstringURI of the image used as the main marker for this icon
ImageWidthint32Width in pixels of the marker
ImageHeightint32Height in pixels of the marker
ImageOffsetXint32Horizontal anchor position in pixels of the marker
ImageOffsetYint32Vertical anchor position in pixels of the marker
ShadowSrcstringURI of the image used as the shadow for this icon
ShadowWidthint32Width in pixels of the shadow
ShadowHeightint32Height in pixels of the shadow
ShadowOffsetXint32Horizontal anchor position in pixels of the shadow
ShadowOffsetYint32Vertical anchor position in pixels of the shadow
LabelAlignstringSee Usage Notes.
Space separated horizontal and vertical alignment values
LabelOffsetXint32Horizontal anchor position in pixels of the label
LabelOffsetYint32Vertical anchor position in pixels of the label