com.esri.arcgis.schematic
Interface INgBoundedFilter

All Superinterfaces:
Serializable
All Known Implementing Classes:
INgBoundedFilterProxy, NgBoundedFilter

public interface INgBoundedFilter
extends Serializable

Provides access to members that control the bounded property filter.

Description

A bounded property filter corresponds to a specific value range of a bounded property.

Bounded filters can be created either through the Schematics Designer GUI when you define your project parameters or using the AddFilter method available from the INgBoundedProperty interface in your code.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

See Also:
INgDiscreteFilter, INgBoundedProperty.addFilter(int, String, java.lang.Object, java.lang.Object), INgBoundedProperty, INgPropertyFilter

Method Summary
 void addPatternModel(INgPatternModel patternModel)
          Relates the pattern model 'patternModel' to the bounded property filter.
 Object getEffect(int effect)
          Returns the effect 'effect' set for the bounded property filter (see esriNgBoundedFilterEffect).
 INgFilterEffects getFilterEffects()
          List of the effects defined for the bounded property filter.
 String getName()
          Name of the bounded property filter.
 int getNumber()
          Number associated with the bounded property filter.
 INgPatternModels getPatternModels()
          List of the pattern models related to the bounded property filter.
 INgBoundedProperty getProperty()
          Bounded property related to the bounded property filter.
 Object getSubSymbolEffect(String subName, int effect)
          Returns the effect 'effect' set for the sub-symbol named 'subName' (see esriNgSubSymbolEffect) inside the symbol used to represent the bounded property filter.
 boolean isEffectSet(int effect)
          Indicates if the effect 'effect' related to the bounded property filter is set (see esriNgBoundedFilterEffect).
 boolean isSubSymbolEffectSet(String subName, int effect)
          Indicates if the effect 'effect' related to the sub-symbol named 'subName' inside the symbol used to represent the bounded property filter is set (see esriNgSubSymbolEffect).
 void removeEffect(int effect)
          Removes the effect or restores the default effect 'effect' set for the bounded property filter.
 void removePatternModel(INgPatternModel patternModel)
          Removes the relation between the bounded property filter and the pattern model 'patterModel'.
 void removePatternModels()
          Removes the relations between the bounded property filter and all its pattern models.
 void removeSubSymbolEffect(String subName, int effect)
          Removes the effect 'effect' for the sub-symbol named 'subName' inside the symbol used to represent the bounded property filter.
 void setEffect(int effect, Object effValue)
          Modifies the effect 'effect' set for the bounded property filter (see esriNgBoundedFilterEffect).
 void setName(String pVal)
          Name of the bounded property filter.
 void setSubSymbolEffect(String subName, int effect, Object effValue)
          Sets the effect 'effect' for the sub-symbol named 'subName' (see esriNgSubSymbolEffect) inside the symbol used to represent the bounded property filter.
 

Method Detail

getNumber

int getNumber()
              throws IOException,
                     AutomationException
Number associated with the bounded property filter.

Description

This number is defined when the bounded filter is created:

- either by calling the INgBoundedProperty AddFilter method in the program code

- or through ArcGIS Schematics Designer, when the bounded filter has been created.

Remarks

Contrary to the Name property, the Number property cannot be redefined.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedProperty.addFilter(int, String, java.lang.Object, java.lang.Object)

getName

String getName()
               throws IOException,
                      AutomationException
Name of the bounded property filter.

Description

This name is defined when the bounded filter is created:

- either by calling the INgBoundedProperty AddFilter method in the program code

- or through ArcGIS Schematics Designer, when the bounded filter has been created.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
The pVal
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedProperty.addFilter(int, String, java.lang.Object, java.lang.Object)

setName

void setName(String pVal)
             throws IOException,
                    AutomationException
Name of the bounded property filter.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
pVal - The pVal (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getEffect

Object getEffect(int effect)
                 throws IOException,
                        AutomationException
Returns the effect 'effect' set for the bounded property filter (see esriNgBoundedFilterEffect).

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
effect - A com.esri.arcgis.schematic.esriNgBoundedFilterEffect constant (in)
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.setEffect(int, java.lang.Object), INgBoundedFilter.removeEffect(int), INgBoundedFilter.isEffectSet(int)

setEffect

void setEffect(int effect,
               Object effValue)
               throws IOException,
                      AutomationException
Modifies the effect 'effect' set for the bounded property filter (see esriNgBoundedFilterEffect).

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
effect - A com.esri.arcgis.schematic.esriNgBoundedFilterEffect constant (in)
effValue - A Variant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.removeEffect(int), INgBoundedFilter.getEffect(int), INgBoundedFilter.isEffectSet(int)

removeEffect

void removeEffect(int effect)
                  throws IOException,
                         AutomationException
Removes the effect or restores the default effect 'effect' set for the bounded property filter.

Description

Note that, if removing an effect that is not set by default really removes the bounded filter effect, removing an effect that is always set returns the bounded filter effect to its default effect value.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
effect - A com.esri.arcgis.schematic.esriNgBoundedFilterEffect constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.setEffect(int, java.lang.Object), INgBoundedFilter.getEffect(int), INgBoundedFilter.isEffectSet(int)

isEffectSet

boolean isEffectSet(int effect)
                    throws IOException,
                           AutomationException
Indicates if the effect 'effect' related to the bounded property filter is set (see esriNgBoundedFilterEffect).

Description

By default, Schematics automatically sets default values for some bounded filter effects (see the List of the bounded filter effect default values, below). For all these effects, the IsEffectSet method returns TRUE.


For the others effects (those that are not automatically set), the IsEffectSet method returns TRUE only if the effect has been set:

- either when the bounded filter's characteristics have been set through Schematics Designer

- or by calling the SetEffect method in the code.


List of the bounded filter effect default values


For details on all possible bounded filter effects, see Constants for Bounded Filter Effects

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
effect - A com.esri.arcgis.schematic.esriNgBoundedFilterEffect constant (in)
Returns:
The isSet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.setEffect(int, java.lang.Object), INgBoundedFilter.removeEffect(int), INgBoundedFilter.getEffect(int)

setSubSymbolEffect

void setSubSymbolEffect(String subName,
                        int effect,
                        Object effValue)
                        throws IOException,
                               AutomationException
Sets the effect 'effect' for the sub-symbol named 'subName' (see esriNgSubSymbolEffect) inside the symbol used to represent the bounded property filter.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
subName - The subName (in)
effect - A com.esri.arcgis.schematic.esriNgSubSymbolEffect constant (in)
effValue - A Variant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.removeSubSymbolEffect(String, int), INgBoundedFilter.getSubSymbolEffect(String, int)

removeSubSymbolEffect

void removeSubSymbolEffect(String subName,
                           int effect)
                           throws IOException,
                                  AutomationException
Removes the effect 'effect' for the sub-symbol named 'subName' inside the symbol used to represent the bounded property filter.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
subName - The subName (in)
effect - A com.esri.arcgis.schematic.esriNgSubSymbolEffect constant (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.setSubSymbolEffect(String, int, java.lang.Object), INgBoundedFilter.getSubSymbolEffect(String, int)

getProperty

INgBoundedProperty getProperty()
                               throws IOException,
                                      AutomationException
Bounded property related to the bounded property filter.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.schematic.INgBoundedProperty
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.

getSubSymbolEffect

Object getSubSymbolEffect(String subName,
                          int effect)
                          throws IOException,
                                 AutomationException
Returns the effect 'effect' set for the sub-symbol named 'subName' (see esriNgSubSymbolEffect) inside the symbol used to represent the bounded property filter.

Description

The sub-symbol's effects may be set:

- either when the bounded filter's characteristics have been set through Schematics Designer

- or by calling the INgBoundedFilter SetSubSymbolEffect method in the code.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
subName - The subName (in)
effect - A com.esri.arcgis.schematic.esriNgSubSymbolEffect constant (in)
Returns:
A Variant
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.setSubSymbolEffect(String, int, java.lang.Object), INgBoundedFilter.removeSubSymbolEffect(String, int)

isSubSymbolEffectSet

boolean isSubSymbolEffectSet(String subName,
                             int effect)
                             throws IOException,
                                    AutomationException
Indicates if the effect 'effect' related to the sub-symbol named 'subName' inside the symbol used to represent the bounded property filter is set (see esriNgSubSymbolEffect).

Description

Returns TRUE if the effect 'effect' for the subName sub-symbol inside the symbol used for the property bounded filter has been set; else it returns FALSE (see esriNgSubSymbolEffect topic).

The sub-symbol's effect can be set:

- either when the bounded filter's characteristics have been set through Schematics Designer

- or by calling the INgBoundedFilter SetSubSymbolEffect method in the code.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
subName - The subName (in)
effect - A com.esri.arcgis.schematic.esriNgSubSymbolEffect constant (in)
Returns:
The isSet
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.setSubSymbolEffect(String, int, java.lang.Object), INgBoundedFilter.getSubSymbolEffect(String, int)

getPatternModels

INgPatternModels getPatternModels()
                                  throws IOException,
                                         AutomationException
List of the pattern models related to the bounded property filter.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.schematic.INgPatternModels
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgLink.getPatternModels(), INgDiscreteFilter.getPatternModels(), INgElementType.getPatternModels()

removePatternModels

void removePatternModels()
                         throws IOException,
                                AutomationException
Removes the relations between the bounded property filter and all its pattern models.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.removePatternModel(com.esri.arcgis.schematic.INgPatternModel)

removePatternModel

void removePatternModel(INgPatternModel patternModel)
                        throws IOException,
                               AutomationException
Removes the relation between the bounded property filter and the pattern model 'patterModel'.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
patternModel - A reference to a com.esri.arcgis.schematic.INgPatternModel (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.addPatternModel(com.esri.arcgis.schematic.INgPatternModel), INgBoundedFilter.removePatternModels()

addPatternModel

void addPatternModel(INgPatternModel patternModel)
                     throws IOException,
                            AutomationException
Relates the pattern model 'patternModel' to the bounded property filter.

Description

By associating a pattern model with a bounded property filter defined for a link element type, all the links associated with this bounded filter will be displayed with the patterns from this pattern model.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Parameters:
patternModel - A reference to a com.esri.arcgis.schematic.INgPatternModel (in)
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgElementType.addPatternModel(com.esri.arcgis.schematic.INgPatternModel), INgLink.addPatternModel(com.esri.arcgis.schematic.INgPatternModel), INgDiscreteFilter.addPatternModel(com.esri.arcgis.schematic.INgPatternModel)

getFilterEffects

INgFilterEffects getFilterEffects()
                                  throws IOException,
                                         AutomationException
List of the effects defined for the bounded property filter.

Description

Note that if this method returns all the bounded filter effects, you can get a specific effect by using the GetEffect method.

Product Availability

Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server.

Returns:
A reference to a com.esri.arcgis.schematic.INgFilterEffects
Throws:
IOException - If there are interop problems.
AutomationException - If the ArcObject component throws an exception.
See Also:
INgBoundedFilter.getEffect(int)