com.ibm.workplace.wcm.api
Interface RichTextComponent

All Superinterfaces:

ContentComponent

public interface RichTextComponent

extends ContentComponent

Represents a Rich Text component.

A RichTextComponent is a ContentComponent and cannot be stored as a separate entity in the repository.

A RichTextComponent can contain formatted rich text.

See Also:

ContentComponent

Field Summary

static java.lang.String

COPYRIGHT Copyright statement

Method Summary

java.lang.String	getRichText() Returns the rich text contained in this component as a String representation of the HTML.
void	setRichText(java.lang.String p_richText) Sets the rich text in the component from a String of HTML.
void	setRichText(java.lang.String p_richText, EmbeddedImageMap p_images) Sets the rich text in the component from a String of HTML and embedded images.

Methods inherited from interface com.ibm.workplace.wcm.api.ContentComponent

getContainer, getName

Field Detail

COPYRIGHT

public static final java.lang.String COPYRIGHT

Copyright statement

See Also:

Constant Field Values

Method Detail

getRichText

public java.lang.String getRichText()

Returns the rich text contained in this component as a String representation of the HTML.

Returns:

the rich text

setRichText

public void setRichText(java.lang.String p_richText)
                 throws OperationFailedException

Sets the rich text in the component from a String of HTML.

Note. This method replaces any existing rich text. It does not append to existing rich text.

Parameters:

p_richText - the rich text (HTML)

Throws:

OperationFailedException - if the rich text could not be set

java.lang.NullPointerException - if the argument to this method is null

setRichText

public void setRichText(java.lang.String p_richText,
                        EmbeddedImageMap p_images)
                 throws OperationFailedException

Sets the rich text in the component from a String of HTML and embedded images. The URL from the src attribute of the img tag must have a corresponding entry in an EmbeddedImageMap object that you add via the addImage method.

A WCM resource is created for the image when you save the workspace The src attribute in the img tag will be replaced by a WCM resource's url. If the same URL appears in the HTML more than once, the same WCM resource will be used.

Note. This method replaces any existing HTML in this component. It does not append to existing HTML. Existing images will be removed, new images will be added.

Example code:

  File file = new File("C:/example/image.jpg");
  EmbeddedImageMap embeddedImage = new EmbeddedImageMap();
  embeddedImage.addImage("c:/example/image.jpg", file);

  // Set HTML
  rteComponent.setRichText(rteText, embeddedImage);
 

Parameters:

p_richText - the rich text (HTML)

p_images - a map of URLs to images

Throws:

OperationFailedException - if the string argument is null or the HTML could not be set