|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface ISymbolCollectionElement
Provides further access to members that control Collection Symbol Elements.
Annotation feature classes often contain many text elements referencing text symbols with the same properties. Rather than redundantly storing the same symbol with each feature in the feature class, annotation feature classes are created with a symbol collection and the TextElements of annotation features can reference symbols in this collection.
ISymbolCollectionElement provides access to properties of TextElements which reference TextSymbols stored in a SymbolCollection as part of Geodatabase Annotation Feature Classes. When editing the TextElements of annotation features, it is critical that this interface is used in order to maintain the linkage to the SymbolCollection symbol. Accessing and updating symbol properties through ITextElement::Symbol will cause the TextElement to become disconnected from the SymbolCollection symbol and the symbol will be stored inline with the feature in the feature class. This is undesirable since TextSymbols can be large in size.
When referencing a symbol in the collection, it is possible to override some of the TextSymbol properties without disconnecting it from the symbol collection symbol. The following properties are overridable: XOffset, YOffset, Horizontal Alignment, Vertical Alignment, Flip Angle, Size, Color, Character Spacing, Character Width, Word Spacing, Leading, Bold, Italic, Underline, Background, and Font Name. Setting any of these properties via ISymbolCollectionElement will properly apply the override to the element. Utilizing overrides instead of disconnecting the element from the SymbolCollection will help minimize the amount of storage required. If you find yourself needing to override many properties to reach the desired appearance for a lot of features, it is recommended that you add another symbol to the symbol collection rather than storing many overrides.
If a element is not referencing a symbol in the SymbolCollection, ISymbolCollectionElement::SymbolID will report a value of -1. Otherwise, it will report the ID of the referenced text symbol.
The property ISymbolCollectionElement::OverriddenProperties reports the value of combined overrides applied to the current element. See the help for this property for an example of how to evaluate this property. If the SymbolID of the element is -1, this property will always report 0.
Method Summary | |
---|---|
void |
drawESRIAnno(IStream stream,
ISymbolCollection symbolCollection,
ISpatialReference spatialRef,
IDisplay display)
Draws the anno in a compressed format. |
void |
exportToESRIAnno(IStream stream)
Saves the anno in a compressed format. |
ITextBackground |
getBackground()
Background symbol. |
double |
getCharacterSpacing()
The character spacing. |
double |
getCharacterWidth()
The character width. |
IColor |
getColor()
Font color. |
double |
getFlipAngle()
Flip angle. |
String |
getFontName()
Font name. |
IGeometry |
getGeometry()
Shape of the element as a geometry. |
int |
getHorizontalAlignment()
Horizontal alignment style. |
double |
getLeading()
The character leading. |
int |
getOverriddenProperties()
Overridden properties. |
int |
getOverriddenPropertiesExclusionMask()
Mask used to exclude overrides when drawing. |
ISymbol |
getSharedSymbol()
Collection symbol. |
double |
getSize()
Font size. |
int |
getSymbolID()
Symbol ID associated with this element. |
String |
getText()
Text being displayed by this element. |
ITextPath |
getTextPath()
Text path. |
int |
getVerticalAlignment()
Vertical alignment style. |
double |
getWordSpacing()
The word spacing. |
double |
getXOffset()
Text offset along X-axis. |
double |
getYOffset()
Text offset along Y-axis. |
void |
importFromESRIAnno(IStream stream,
ISpatialReference spatialReference,
ISymbolCollection symbolCollection)
Loads the anno in a compressed format. |
boolean |
isBold()
Indicates whether bold fonts style. |
boolean |
isItalic()
Indicates whether italic font style. |
boolean |
isUnderline()
Indicates whether underline font style. |
IPoint |
ISymbolCollectionElement_getAnchorPoint()
Callout anchor point. |
void |
setAnchorPoint(IPoint anchorPoint)
Callout anchor point. |
void |
setBackgroundByRef(ITextBackground symbol)
Background symbol. |
void |
setBold(boolean bold)
Indicates whether bold fonts style. |
void |
setCharacterSpacing(double characterSpacing)
The character spacing. |
void |
setCharacterWidth(double characterWidth)
The character width. |
void |
setColor(IColor color)
Font color. |
void |
setFlipAngle(double flipAngle)
Flip angle. |
void |
setFontName(String fontName)
Font name. |
void |
setGeometry(IGeometry pGeometry)
Shape of the element as a geometry. |
void |
setHorizontalAlignment(int horizAlignment)
Horizontal alignment style. |
void |
setItalic(boolean italic)
Indicates whether italic font style. |
void |
setLeading(double leading)
The character leading. |
void |
setOverriddenProperties(int props)
Overridden properties. |
void |
setOverriddenPropertiesExclusionMask(int mask)
Mask used to exclude overrides when drawing. |
void |
setSharedSymbol(int symbolID,
ISymbol rhs2)
The symbol ID associated with this element. |
void |
setSize(double pointSize)
Font size. |
void |
setText(String text)
Text being displayed by this element. |
void |
setTextPathByRef(ITextPath textPath)
Text path. |
void |
setUnderline(boolean underline)
Indicates whether underline font style. |
void |
setVerticalAlignment(int vertAlignment)
Vertical alignment style. |
void |
setWordSpacing(double wordSpacing)
The word spacing. |
void |
setXOffset(double xOffset)
Text offset along X-axis. |
void |
setYOffset(double yOffset)
Text offset along Y-axis. |
Method Detail |
---|
int getSymbolID() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setSharedSymbol(int symbolID, ISymbol rhs2) throws IOException, AutomationException
symbolID
- The symbolID (in)rhs2
- A reference to a com.esri.arcgis.display.ISymbol (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.ISymbol getSharedSymbol() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void exportToESRIAnno(IStream stream) throws IOException, AutomationException
stream
- A reference to a com.esri.arcgis.system.IStream (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void importFromESRIAnno(IStream stream, ISpatialReference spatialReference, ISymbolCollection symbolCollection) throws IOException, AutomationException
stream
- A reference to a com.esri.arcgis.system.IStream (in)spatialReference
- A reference to a com.esri.arcgis.geometry.ISpatialReference (in)symbolCollection
- A reference to a com.esri.arcgis.display.ISymbolCollection (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void drawESRIAnno(IStream stream, ISymbolCollection symbolCollection, ISpatialReference spatialRef, IDisplay display) throws IOException, AutomationException
stream
- A reference to a com.esri.arcgis.system.IStream (in)symbolCollection
- A reference to a com.esri.arcgis.display.ISymbolCollection (in)spatialRef
- A reference to a com.esri.arcgis.geometry.ISpatialReference (in)display
- A reference to a com.esri.arcgis.display.IDisplay (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.double getXOffset() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setXOffset(double xOffset) throws IOException, AutomationException
xOffset
- The xOffset (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.double getYOffset() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setYOffset(double yOffset) throws IOException, AutomationException
yOffset
- The yOffset (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getVerticalAlignment() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setVerticalAlignment(int vertAlignment) throws IOException, AutomationException
vertAlignment
- A com.esri.arcgis.display.esriTextVerticalAlignment constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getHorizontalAlignment() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setHorizontalAlignment(int horizAlignment) throws IOException, AutomationException
horizAlignment
- A com.esri.arcgis.display.esriTextHorizontalAlignment constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.double getFlipAngle() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setFlipAngle(double flipAngle) throws IOException, AutomationException
flipAngle
- The flipAngle (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IPoint ISymbolCollectionElement_getAnchorPoint() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setAnchorPoint(IPoint anchorPoint) throws IOException, AutomationException
anchorPoint
- A reference to a com.esri.arcgis.geometry.IPoint (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.double getSize() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setSize(double pointSize) throws IOException, AutomationException
pointSize
- The pointSize (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IColor getColor() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setColor(IColor color) throws IOException, AutomationException
color
- A reference to a com.esri.arcgis.display.IColor (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.ITextPath getTextPath() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setTextPathByRef(ITextPath textPath) throws IOException, AutomationException
textPath
- A reference to a com.esri.arcgis.display.ITextPath (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.double getCharacterSpacing() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setCharacterSpacing(double characterSpacing) throws IOException, AutomationException
characterSpacing
- The characterSpacing (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.double getCharacterWidth() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setCharacterWidth(double characterWidth) throws IOException, AutomationException
characterWidth
- The characterWidth (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.double getWordSpacing() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setWordSpacing(double wordSpacing) throws IOException, AutomationException
wordSpacing
- The wordSpacing (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.double getLeading() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setLeading(double leading) throws IOException, AutomationException
leading
- The leading (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isBold() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setBold(boolean bold) throws IOException, AutomationException
bold
- The bold (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.String getFontName() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setFontName(String fontName) throws IOException, AutomationException
fontName
- The fontName (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isItalic() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setItalic(boolean italic) throws IOException, AutomationException
italic
- The italic (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.boolean isUnderline() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setUnderline(boolean underline) throws IOException, AutomationException
underline
- The underline (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.ITextBackground getBackground() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setBackgroundByRef(ITextBackground symbol) throws IOException, AutomationException
symbol
- A reference to a com.esri.arcgis.display.ITextBackground (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setOverriddenProperties(int props) throws IOException, AutomationException
props
- The props (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getOverriddenProperties() throws IOException, AutomationException
This property returns the sum of values which represent the overriden properties of this element. This property can be evaluated by performing an Xor comparison of the value and the individual override values availible from esriSymbolOverrideEnum. If the element is not referencing a symbol in the symbol collection, this value will be 0.
To reset the element to have no overrides, set the value of the property to 0. Putting values into this property can be used to clear overrides. For instance, if the overrride value is 3 meaning that both X and Y Offset are overriden, you can set the override value to 1 and remove the Y Offset.
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setOverriddenPropertiesExclusionMask(int mask) throws IOException, AutomationException
mask
- The mask (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.int getOverriddenPropertiesExclusionMask() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.String getText() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setText(String text) throws IOException, AutomationException
text
- The text (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.IGeometry getGeometry() throws IOException, AutomationException
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.void setGeometry(IGeometry pGeometry) throws IOException, AutomationException
pGeometry
- A reference to a com.esri.arcgis.geometry.IGeometry (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |