New Feature: Find Shape by Data Property

[dave-howard]

the ability to find a shape by it's data properties, either property name, label, or value would have advantages over:

• find by id (id might change when moved, copied, and is not easy to find), and
• by shape text, which is visible in end diagram, unless removed after the shape is found

Shape Data would be a good way to identify shapes that require some action performed on them. methods may look like:

• page.find_shape_by_data_name(data_property_name: str)
• page.find_shape_by_data_value(data_property_value: str)
• page.find_shape_by_data(data_property_name: str, data_property_value)

the first has the advantage of not having to look beyond the property row, the value requires finding cell element, but this should be a very minimal overhead each of the methods may be supplimented with a page.find_shapes_by_xxx that returns a list of matching shapes

[dave-howard]

Each of these should also be available from Shape object, to find a sub shape by data_property within that shape The Shape class should store the ShapeProperty items in a dict indexed on name so that it can be quickly retrieved to support these methods.

[dave-howard]

Added in v0.4.10 but used Shape data label instead of name, as these are more readily visible in Visio than property names and values - so they are a better way of identifing shapes to be manipulated.

Done