This document is provided on an "AS IS" basis without warranties of any kind. Smartsite iXperion class libraries may change in future releases.

Syntax

C# Copy imageCopy Code
                                  public class ImageModule
Visual Basic (Declaration) Copy imageCopy Code
                                  Public Class ImageModule

The type exposes the following members.

Public Constructors

  Name Description
Public method ImageModule

Public Methods

  Name Description
Public method AddAIMRelation
Adds an item to the AIM relations collection.
(Inherited from Module.)
Public method ApplyProperties
Applies the properties from the SXML processing environment into the current module.
(Inherited from BaseModule.)
Public method BeginExecute
Override this to execute code before Execute() is fired.
Last point to add data to the Cache Signature.
(Inherited from Module.)
Public method Capture
Passes an SXML subtree to the current module.
(Inherited from BaseModule.)
Public method CheckTimeout
Checks whether execution has timed out, given the setting of TimeoutMilliseconds()()()().
(Inherited from BaseModule.)
Public method ClearForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method Dispose
Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
(Inherited from BaseModule.)
Public method DoPreparse
Check whether to preparse data in the given property.
(Inherited from BaseModule.)
Public method DoRecurseTag
Determines whether to recurse on a given tag
Public method EndExecute
Override this to execute code after Execute() is fired.
(Inherited from Module.)
Public method Equals (Inherited from Object.)
Public method EvaluatePropertyExpression
Evaluates an expression in a property with Expression Syntax
(Inherited from Module.)
Public method Execute
Execute the macro. Should be overridden by inherited class.
(Overrides Module..::Execute()()()().)
Public method ExecuteRawParameter
Executes the data of a raw parameter.
(Inherited from Module.)
Public method ExistsBuffer
Checks whether a local buffer exists.
(Inherited from BaseModule.)
Public method Find
Finds the specified child module.
(Inherited from BaseModule.)
Public method FindExtension
Finds an extension macro.
(Inherited from BaseModule.)
Public method GetAIMRelations
Gets a list of all outgoing AIM relations created by the macro.
(Inherited from BaseModule.)
Public method GetAltText
Gets the HTML alt text attribute of the image.
Public method GetBuffer
Gets a local buffer.
(Inherited from BaseModule.)
Public method GetClassName
Gets the value for the HTML class attribute of the image.
Public method GetException
Returns the text message of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetExceptionSmartsiteCode
Returns the Smartsite Error code of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetExceptionString
Returns the full information of the exception that has occurred, including the stack trace.
(Inherited from BaseModule.)
Public method GetExceptionType
Returns the full Type name of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetForcedResult
Gets the forced result of the macro, set by overriding the normal rendering using SetForcedResult().
(Inherited from Module.)
Public method GetHashCode (Inherited from Object.)
Public method GetImageId
Gets the value for the HTML id attribute of the image.
Public method GetInnerException
Returns the text message of the inner exception of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetInnerExceptionSmartsiteCode
Returns Smartsite error code of the inner exception of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetInnerExceptionString
Returns the full information of the inner exception of the exception that has occurred, including the stack trace.
(Inherited from BaseModule.)
Public method GetInnerExceptionType
Returns the full Type name of the inner exception of the exception that has occurred.
(Inherited from BaseModule.)
Public method GetOnClick
Gets the HTML onclick attribute of the image.
Public method GetOutputColorDepth
Gets the color depth of the output image.
Public method GetOutputCommandOrder
Gets the actual applied command order.
Public method GetOutputFileSize
Gets the file size in bytes of the output image.
Public method GetOutputFileType
Gets the file type of the output image.
Public method GetOutputFrameCount
Gets the number of frames in the output image.
Public method GetOutputHeight
Gets the calculated height of the output.
Public method GetOutputLocation
Gets the output location.
Public method GetOutputResolutionUnit
Gets the resolution unit of the output image.
Public method GetOutputResolutionX
Gets the horizontal resolution of the output image.
Public method GetOutputResolutionY
Gets the vertical resolution of the output image.
Public method GetOutputStyle
Gets the calculated output style. Returns null if parameter AddStyle is false.
Public method GetOutputWidth
Gets the calculated width of the output.
Public method GetParameter
Gets the value of the given parameter/property.
(Inherited from BaseModule.)
Public method GetParameter
Gets the value of the given parameter/property.
(Inherited from BaseModule.)
Public method GetParent
Gets the parent Module of this module.
(Inherited from BaseModule.)
Public method GetParent
Gets the parent Module of this module, optionally crossing RenderContext boundaries if allowed so by embeds (Sandboxing off).
(Inherited from BaseModule.)
Public method GetRenderTime
Returns the render time of the macro in milliseconds.
(Inherited from Module.)
Public method GetResult
Returns the result of the macro.
Typically used in the ResultFormat property, to format, convert or encode the result.
(Inherited from BaseModule.)
Public method GetResult
Returns the result of the macro.
Typically used in the ResultFormat property, to format, convert or encode the result.
(Inherited from BaseModule.)
Public method GetTitle
Gets the title attribute of the image.
Public method GetType (Inherited from Object.)
Public method Initialize Overloaded.
Public method IsChildOf
Determines whether the module is a descendant of the given parent
(Inherited from BaseModule.)
Public method ParameterExists
Checks whether the given parameter/property is set.
(Inherited from BaseModule.)
Public method PreInitialize
Called just before initialization of the module
(Overrides Module..::PreInitialize(IContext, IProcessingContext).)
Public method ReadyExecuting
Method that is called after the module has executed.
(Inherited from Module.)
Public method ScopeTerminated
Executed when the module is about to get out of scope.
(Inherited from BaseModule.)
Public method SetBuffer
Sets a local buffer.
(Inherited from BaseModule.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method SetForcedResult
Sets the result of the macro.
used to override the normal handling of the result creation.
(Inherited from Module.)
Public method TestCondition
Tests whether execution should take place based on the expression in the condition property
(Inherited from Module.)
Public method TestPropertyExpression
Tests whether an expression in a property with Expression Syntax evaluates to true.
(Inherited from Module.)
Public method ThrowCurrentException
Makes Smartsite throw the current exception.
(Inherited from BaseModule.)
Public method ThrowInnerException
Makes Smartsite throw the inner exception.
(Inherited from BaseModule.)
Public method ToString
Returns a string that represents the current macro.
(Inherited from Module.)
Public method ToString
Returns a String that represents the current Object.
(Inherited from Module.)
Public method Static member TransformImage
Transforms the specified image using the specified commands.
Public method Static member TransformImageBytes
Transforms the specified image using the specified commands.

Protected Methods

  Name Description
Protected method Finalize (Inherited from Object.)
Protected method IsBufferName
Determines whether the data is a buffer name.
(Inherited from Module.)
Protected method IsSingleSaveBuffername
Determines whether a single save buffername is used.
(Inherited from Module.)
Protected method MemberwiseClone (Inherited from Object.)
Protected method SetCurrentProperty
Sets the current property.
(Inherited from BaseModule.)

Protected Fields

  Name Description
Protected field DoExecute
Specifies whether to execute the module
(Inherited from BaseModule.)
Protected field InternalAIMMode
Cotnains the internal AIM mode.
(Inherited from Module.)
Protected field InternalCopyFormatting
The id of the macro to copy the formatting settings from.
(Inherited from Module.)
Protected field InternalFormatting
Formatting settings.
(Inherited from Module.)
Protected field ResolvingSaveBuffers
True when save buffers are evaluated.
(Inherited from BaseModule.)
Protected field savingUnformattedResult
True when save buffers are checked before formatting is applied, to facilitate unformated data to be saved.
(Inherited from BaseModule.)

Public Properties

  Name Description
Public property AcceptsInnerXml
Returns true if the module currently accepts string data within the macro tags.
(Inherited from BaseModule.)
Public property AccessDeniedReturnValue
Gets or sets the value that is returned when the site visitor has insufficient access.
(Inherited from Module.)
Public property AddStyle
Gets or sets a value indicating whether to add a style attribute to the output.
Public property AIMMode
Gets or sets the AIM scanning mode of the macro.
(Inherited from Module.)
Public property AIMOrigin
Returns the current AIM source. If AIMMode is Autonomous, the current instructionsource is used, otherwise the current item.
(Inherited from Module.)
Public property AltText
Gets or sets the alt text property for the image.
Public property AspectRatio
Gets or sets a value indicating whether to keep the aspect ratio when the image is resized.
Public property AutoTitle
Gets or sets a value indicating whether to automatically copy a title attribute from the AltText, if not specified.
Public property BufferNames
Gets or sets the buffer names.
(Inherited from Module.)
Public property ClassName
Gets or sets the class name attribute of the image.
Public property CommandOrder
Gets or sets the order in which the image commands are being applied.
Public property Condition
Gets or sets the Viper expression to evaluate before actually executing the macro.
If the expression returns false, the execution of the module and its child modules is skipped.
(Inherited from Module.)
Public property ConditionMatched
Must return true if TestCondition() matched.
(Inherited from Module.)
Public property CropBottom
Gets or sets the crop bottom.
Public property CropHeight
Gets or sets the height of the crop.
Public property CropLeft
Gets or sets the crop left.
Public property CropRight
Gets or sets the crop right.
Public property CropTop
Gets or sets the crop top.
Public property CropWidth
Gets or sets the width of the crop.
Public property CurrentCacheModule
Returns a reference to the current cache module, if the current instruction is encapsulated by a cache block.
(Inherited from Module.)
Public property CurrentProperty
Gets the property currently being set on the module.
(Inherited from BaseModule.)
Public property DefaultValue
Gets or sets the default value that will be returned when the execution would otherwise return an empty string.
(Inherited from Module.)
Public property DuoToneTint
Gets or sets the tint color of the duo tone effect.
Public property FallbackImage
Sets the location for the image to be used when the image specified in the Location parameter cannot be found.
Public property FileType
Gets or sets the file type of the image. Possible values are define in the imageFileTypes collection in the Smartsite.ImageProcessor.config file.
Public property Formatting
Gets the formatting options.
(Inherited from Module.)
Public property Grayscale
Gets or sets a value indicating whether this generated image is grayscale.
Public property HasParameterSection
Returns true if the macro currently uses an SXML parameters section
(Inherited from BaseModule.)
Public property Height
Gets or sets the image height.
Public property Id
Gets or sets the unique id of the module instance during the current processing.
Modules with Id set will be kept alive during the complete rendering and can be accessed from other modules using the Find method.
(Inherited from BaseModule.)
Public property ImageId
Gets or sets the id attribute of the image.
Public property InputData
Gets or sets the input data. This must be a datatable containing the image.
Public property IsCancelled
Gets a value indicating whether the execution of the macro is cancelled.
(Inherited from BaseModule.)
Public property IsSelfClosing
Gets a value indicating whether this instance is self closing.
(Inherited from BaseModule.)
Public property JpgQuality
Sets the JPG quality.
Public property LocalId
Gets or sets the local id of the macro in the current buffer scope.
(Inherited from Module.)
Public property Location
Sets the location of the image. This can be either a smartsite item or a site file.
Public property MaxHeight
Gets or sets the maximum height.
Public property MaxWidth
Gets or sets the maximum width.
Public property MinHeight
Gets or sets the minimum height.
Public property MinimumAccessTypeLevel
Friendly name of the minimum access type level required by the site visitor to execute this macro.
(Inherited from Module.)
Public property MinWidth
Gets or set the minimum width.
Public property Mirror
Gets or sets the mirror type.
Public property ModuleInfo
Gets the module info.
(Inherited from BaseModule.)
Public property OilPaint
Gets or sets a value indicating whether to apply the oil paint effect.
Public property OnClick
Gets or sets the onclick attribute of the image.
Public property OnErrorReturnValue
Gets or sets the value to return in case on error occurs during execution.
The Viper expressions this.error(), this.error(full) and this.error(type) are available in this context.
(Inherited from Module.)
Public property Properties
Gets the full list of properties as set when executing the module.
(Inherited from BaseModule.)
Public property Remarks
Gets or sets the remarks. Remarks have no effect on the actual execution of the module.
They only improve the readability of the code.
(Inherited from BaseModule.)
Public property ResizeMode
Gets or sets the resize mode.
Public property Result
Returns a reference to the module result
(Inherited from BaseModule.)
Public property ResultFormat
Gets or sets the resultformat.
(Inherited from Module.)
Public property ResultType
Gets or sets the type of the result.
(Inherited from BaseModule.)
Public property Rotate
Gets or sets the rotation angle in degrees.
Public property RotateBackColor
Gets or sets the background color after a rotation has occurred.
Public property State
Gets a key/value collection that can be used to organize and share data during the lifecycle of a module.
(Inherited from BaseModule.)
Public property Status
Gets a value indicating the ModuleStatus of this module.
(Inherited from BaseModule.)
Public property Style
Gets or sets the style attribute of the image.
Public property SXMLPath
Gets the path to the macro in the current execution stack.
(Inherited from BaseModule.)
Public property TimeoutSeconds
Gets or sets the timeout in seconds. In the overriden Execute() method, you can call CheckTimeout() to check whether execution has timed out.
(Inherited from BaseModule.)
Public property Title
Gets or sets the title property for the image.
Public property Trim
Gets a value indicating how the whitespace is trimmed.
(Inherited from BaseModule.)
Public property TypeName
Gets the name of the Module type.
(Inherited from BaseModule.)
Public property UseFallbackImage
Gets or sets a value indicating whether to use a fallback image if the given location proves to be invalid.
Public property UserSetPropertyList
Gets the user-set property list.
(Inherited from BaseModule.)
Public property Whitespace
Gets a value indicating whether to preserve whitespace.
(Inherited from BaseModule.)
Public property Width
Gets or sets the image width.

Protected Properties

  Name Description
Protected property IContext
Gets a reference to the IContext interface.
(Inherited from BaseModule.)

Public Events

  Name Description
Public event SetProperty
Event fired just before setting a property on the Module instance from the SXML processor.
(Inherited from BaseModule.)
Public event StatusChange
Event raised when the execution status changes.
(Inherited from BaseModule.)

Explicit Interface Implementations

See Also

Advanced