Custom selection context commands

[GeKtvi]

SolidDNA changes

Summary

This PR adds a more structured API for SolidDNA context menu popup icons and context menu items (groups/submenus), plus updates the Menus tutorial (Tutorials/05-Menus) with improved examples, icon assets, and documentation.

Key changes

• Introduced context menu item/icon abstractions (CommandContext* types) and related create-info / created-state types.
• Made context menu creation more explicit and safer (creation failures throw, cookie is passed explicitly via info objects).
• Updated CommandManager construction to accept the SolidWorks add-in cookie (new constructor overload) and store it for context-menu registration, the old constructor is marked obsolete. SolidWorks APIs require this cookie for registration but it cannot be read back from the ICommandManager object, so it must be passed in. This avoids relying on global application access for the cookie and makes the lifetime/ownership clearer.
• Added/updated tutorial assets and examples for:
  • command tab / flyout icons via sprite sheets (Icons/icons{size}.png)
  • context menu icons via per-size icon files (Icons/icon_*{size}.png)
• Added unit-style tests for context menu items/groups/icons that **.
• NOTE: Application realted tests are intentionally not added yet because the repo currently has the new IApplication/Application naming/property situation and I don’t want to build changes on top of that until it’s stabilized/renamed.
• Added documentation/comments explaining why context menu item/icon removal is not implemented.
• Expanded comments and docs around context menu usage, selection-type filtering, and state checks.

Main types

• Two-phase model (Creatable → Created):
  • CommandContext* classes are configuration + top-level creation logic (what to create, for which doc types, which selection context, how to build nested paths).
  • CommandContext*Created classes are the registered SolidWorks artifacts (what was actually added to the UI) and own the created-state lifetime/disposal behavior.
• Immutability boundary:
  • CommandContextItem / CommandContextIcon are intended to be treated as creation-time configuration, after Create(...) they effectively become immutable for a given registration (prevents “create twice / change fields / create again” issues).
• Creation context is explicit:
  • ICommandContextCreateInfo carries runtime data like the SolidWorks cookie, CommandContextItemCreateInfo additionally carries the current path for nested @ hierarchy.
• Groups are a composition mechanism:
  • CommandContextGroup is a creatable “container” that creates a CommandContextGroupCreated.
  • CommandContextGroupCreated holds the created children and is responsible for disposing them (and for passing derived create info, like the nested path, down to child items).

Design notes / rationale

• SRP split (Create vs Created): one type is responsible for creation/transition to a created state, the created type owns lifetime + disposal responsibilities.
• Creation is a state transition: base Create should only move an object to a “created” state.
• Prefer IEnumerable<T> for returned collections (details/justification): Iterator pattern approach discussion
• Command ID immutability: avoid mutating CommandId after creation to prevent inconsistent CommandManager state.

Style / conventions

• Uses newer C# syntax where applicable (modern collection expressions, etc.). This is intended to match the library direction, if the repo prefers older syntax, I can align it in a follow-up.
• New/updated code prefers _field naming over legacy mField naming (older classes may still use m).
• Avoids #region blocks in small classes (keeps files shorter and relies on IDE navigation instead).

SolidWorks API context

Raw SolidWorks API interop

• Context menu items are registered via ISldWorks.AddMenuPopupItem3 per (DocumentType, SelectionType) combination, using the add-in cookie and SolidDNA callback strings (SolidAddIn.Callback(CallbackId) / SolidAddIn.ItemStateCheck(CallbackId)).
• Context menu popup icons are registered via IFrame.AddMenuPopupIcon3 (frame obtained from ISldWorks.Frame), also using the add-in cookie plus the same callback/update pattern.

SolidWorks API bugs / limitations

• Separators via ISldWorks.AddMenuPopupItem3: SolidWorks documentation suggests you can add a separator by appending an at-sign (@) and quoting the popup item name, but this does not work (observed on SW 2022 and 2024). SolidWorks still parses the quoted string and treats the empty part as a submenu name.
• Popup icon image list behavior: if multiple batch icons are provided, SolidWorks uses the first icon (no index support).
• Icon state support: for popup icons, only SelectedEnabled, DeselectedEnabled, and Hidden states are supported, disabled states are not supported.

Removal / unregister limitations (Dispose strategy)

• Removal is not reliably supported (Dispose strategy): SolidWorks does not reliably support removing context entries once registered, so SolidDNA uses a hide-by-state-check approach.
  • This is an internal implementation detail (CommandContext*Created), library users are not expected to manually dispose these.
  • The CommandManager / add-in lifecycle owns disposal (no manual disposal in normal usage): after disposal, state-check keeps returning Hidden to effectively remove the item/icon from the UI.
  • Context registration is runtime-only: if SolidWorks restarts and the add-in does not register items again, no “old” items/icons remain in the UI.
• Removing context menu items: no reliable API was found to remove items after adding them.
  • ISldWorks.RemoveMenuPopupItem2 always returns false and does not remove the item.
  • ISldWorks.RemoveFromPopupMenu can return true but the item is still not removed.
  • The IFrame.AddMenuPopupItem2 callback path is C++ only.
  • Users can “remove” effectively by returning Hidden via OnStateCheck.
• Removing context menu popup icons: no reliable API was found to remove icons after adding them.
  • IFrame.RemoveMenuPopupIcon is C++ only.
  • Even if you call it, you cannot safely determine the icon index because other add-ins can add icons too.
• Add-in unload behavior: when the add-in is unloaded by the user (SolidWorks: Tools → Add-ins → checkbox unchecked), SolidWorks removes the add-in’s registered context menu items/icons from the UI (this happens regardless of the Hidden/Dispose workaround).
• Add-in reload behavior: when the user loads the add-in again (checkbox checked), SolidWorks runs the add-in connect/startup flow and the items/icons are registered again from scratch and work as usual.

SolidWorks UI/behavior limitations

• Context menu icon count: SolidWorks does not wrap to a new row, too many icons stretches/breaks usability.
  • Consider adding a static/per-version limit with logging once exceeded (avoid throwing to prevent breaking other add-ins).
  • Observed that visible context item count varies by monitor DPI (some items may move under “more commands”).
• Separator does not work reliably: the documented pattern (quoted item name ending with @) does not work reliably (observed SW 2022/2024), SolidWorks still parses @ and treats the empty segment as a submenu name.
• SelectionType quirk (Part FeatureManager): in a Part document, selecting the top “component” entry in FeatureManager appears to be treated by SolidWorks as SelectionType.Component (even though it’s a Part), interesting observation.
• If a context popup for a selection type isn’t shown, it may not be possible to add a context icon for that selection type.

Out of scope / deferred

• Documentation for SpecificFeatureSelectionType (and related selection-type details) is intentionally deferred to a follow-up PR.
• More complex, prebuilt context menu item/icon building blocks (higher-level “ready to use” classes on top of the current CommandContext* primitives) are intentionally deferred to follow-up PRs.
• If SolidDNA’s SolidWorks application access surface (Application / IApplication) changes during/after merge, this PR may need a small follow-up to align with the updated/official application access approach.

[GeKtvi]

Screenshots

Component selection: context menu open + popup icon visible + context menu item + nested group

Edge selection: context popup visible + icon shown

Face selection: context popup visible + icon shown

Popup icon selected state (if applicable)

DPI/overflow example: demonstrate “More commands” / DPI variance

FeatureManager component folder selection: multiple popup icons assigned and shown