To filter the symbols contained in a diagram, specify the filter criteria as a wildcard for the first argument and specify the type of symbol of interest as the second argument, part of which can also be "". This returns an SAObjects collection. The SAObjects collection is not fully populated until the Complete flag for the collection is true. GetFilteredSymbols should be used in conjunction with either ReadAll or IsMoreThan methods.
Any instantiated Diagram class. The diagram must be open.
WildCardName
Use: Required
Data type: String
Filter criteria (for example, "C" = all symbols starting with "C")
Wildcard search is case sensitive.
SAType
Use: Required
Data type: Long
Type of System Architect symbol that is being created (for example, ETCATELEMBUSPROC or 445). See the SYMBOLS.BAS file in the System Architect directory for a list of System Architect symbols and their internal constant names and numbers.
Example
This example returns all "Entity" symbols contained in the diagram starting with the letter "P".
Dim oDiagram as Diagram, oCollectionofSymbols As SAObjects Set oCollectionofSymbols = oDiagram.GetFilteredSymbols("P", ETECACTIVITY) Call oCollectionofSymbols.ReadAll