Previous Document Next Document

Including queries in macros : Understanding the available query criteria : Querying outlines


Querying outlines

You can query the outline properties of the shapes on a page or layer.

To access the outline properties of the current shape, you must prepend the property name with the at sign ( @ ). Thus, @type calls the Outline.Type property of the current shape.

 
You can call an expression without specifying the current shape. However, in this case, the @ operator is unavailable.

Outline queries can return values of any of the other supported object types (see Understanding the available query criteria).

Outlines support the following query criteria:

Query criteria
Description
Example and result
outline.BehindFill()
Returns True if the Behind Fill option is set
 
outline.Color()
Returns the color of the outline, or null if the shape does not have an outline
 
outline.IsHairline()
Returns True if the outline is hairline
 
outline.LineCaps()
Returns a string representing the line-cap type of the outline. Possible values are 'butt', 'round', and 'square'.
 
outline.LineJoin()
Returns a string representing the corner type of the outline. Possible values are 'miter', 'round', and 'bevel'.
 
outline.ScaleWithObject()
Returns True if the Scale Outline with Object option is set
 
outline.Type()
Returns a string representing the outline type. The possible values are 'none', 'solid', 'dot-dash', and 'enhanced'.
@outline[.type = 'solid' or .type = 'dot-dash']
Selects all shapes with solid or dashed outlines
outline.Width()
Returns the width of the outline, in points
@outline > {1 pt}
Checks whether the shape outline is wider than 1 pt

Previous Document Next Document Back to Top

Copyright 2013 Corel Corporation. All rights reserved.