Document the difference between active and selected style (for both APIs.)

[DanRathbun]

SketchUp Ruby API Documentation

@thomthom said in How can I set the style using the C API?

The “active” style is different from the “selected” style if there was been changes made to the rendering options.

Please document the difference(s) between "active" and "selected" in the Style class introduction.

I've noticed that they is a paragraph in the Styles#active_style method:

• While #selected_style is the style being selected in the Style Browser, the #active_style is a different object also including any unsaved style changes. These changes are silently dropped once a new style is selected. To save these changes to the selected style, call #update_selected_style.

This information should also be parroted into the class introduction.

1. Does this imply that there is a temporary style being created ?

2. Explain why there is no "active" style setter, but there is a "selected" setter method / function in both APIs.

3. Explain the differences (if any) with regard to working standalone with a SKP file with the C API, and working on a "Live" model (when the C API becomes "certified" as live-safe.)

:?: