Interface DesignerContext

All Superinterfaces:
ClientContext, CommonContext
All Known Implementing Classes:
DesignerContextImpl, DesignerContextProxy

public interface DesignerContext extends ClientContext
  • Field Details

  • Method Details

    • exportResources

      void exportResources(@NonNull Collection<ResourcePath> resourceIds)
      Shows the project export window (after doing a commit) with the given resource IDs checked.
      Parameters:
      resourceIds - Collection of ProjectResourceIds. Not null, but may be empty.
    • addBeanInfoSearchPath

      void addBeanInfoSearchPath(@NonNull String packageName)
      Adds the given fully-qualified path name to the Introspector's BeanInfo search path. BeanInfos can be important for not only visual beans, but for controlling serialization.
      Parameters:
      packageName - fully-qualified path name. Not null.
    • createSerializer

      XMLSerializer createSerializer()
      Creates a new XML serializer that has been configured by all installed modules for custom serialization delegates
      Returns:
      Not null.
    • getStatusBar

      StatusBar getStatusBar()
      The StatusBar at the bottom of the Designer can be used to display temporary messages and for adding always-present little components that appear in the bottom-right
      Returns:
      Not null.
    • getResourceEditManager

      DesignerResourceEditManager getResourceEditManager()
      Resource edit manager
    • editResourceDocs

      void editResourceDocs(@NonNull Resource resource)
      Opens up the resource notes editor for the given project resources
    • getProjectBrowserRoot

      @NonNull ProjectBrowserRoot getProjectBrowserRoot()
      Returns the root node of the project browser tree, so that modules may add their own nodes.
      See Also:
    • getDesignerPrefs

      @NonNull PersistentProperties getDesignerPrefs()
      Returns a PersistentProperties file that will be stored on a per-user basis for "persistent" but not project-encapsulated preferences
    • getLocalizationManager

      @NonNull DesignerLocalizationManager getLocalizationManager()
      Specified by:
      getLocalizationManager in interface ClientContext
    • getFrame

      @NonNull Frame getFrame()
      Returns the owning frame of the designer. Handy for dialog parents
    • getModule

      @Nullable DesignerModuleHook getModule(String id)
      Returns the running hook object that the module with the given ID contributed to this scope. This is the live hook instance, not its Class. Modules use it to reach each other's APIs at runtime.

      The return type is Object because the hook type varies by scope — a ClientModuleHook in a Vision client, a DesignerModuleHook in the Designer (see DesignerContext#getModule(String), which narrows the return type accordingly). Callers narrow the result to an interface the target module publishes for this purpose — pattern matching covers the absent-module case in the same step:

      if (context.getModule(SFCModule.MODULE_ID) instanceof ClientStepRegistryProvider sfc) {
        var registry = sfc.getStepRegistry();
      }
      

      A null result is the usual way to detect that an optional module is unavailable, so account for it unless the module is a hard dependency of yours.

      Narrowed to DesignerModuleHook here, so no cast is needed to call the standard hook methods. Reaching a module's own API still means casting to the interface that module publishes.

      Specified by:
      getModule in interface ClientContext
      Parameters:
      id - the module ID of the module whose hook you want.
      Returns:
      the module's Designer hook instance, or null if the module is not installed or contributes no Designer-scope hook.
    • getCutAction

      @NonNull Action getCutAction()
    • getCopyAction

      @NonNull Action getCopyAction()
    • getPasteAction

      @NonNull Action getPasteAction()
    • getDeleteAction

      @NonNull Action getDeleteAction()
    • getRenameAction

      @NonNull Action getRenameAction()
    • getTagEditor

      @NonNull TagEditor getTagEditor()
      Returns the TagEditorPanel that can be used to edit/add Tags
    • getTagBrowser

      @NonNull com.inductiveautomation.ignition.designer.tags.frame.TagBrowserFrame getTagBrowser()
      Returns the TagBrowserPanel that can be used to select Tags
    • getOPCBrowser

      @NonNull OPCBrowserPanel getOPCBrowser()
      Returns the OPCBrowserPanel that can be used to browse and import OPC items
    • getQueryBrowserPanel

      @NonNull QueryBrowser getQueryBrowserPanel()
      Returns the DB query browser tool
    • getDockingManager

      @NonNull com.jidesoft.docking.DockingManager getDockingManager()
      Returns the JIDE DockingManager for the Designer
    • getToolbarManager

      @NonNull com.jidesoft.action.DockableBarManager getToolbarManager()
      Returns the JIDE dockable toolbar manager
    • registerResourceWorkspace

      void registerResourceWorkspace(@NonNull ResourceWorkspace workspace)
      Registers a new ResourceWorkspace, which is a main editing area for the designer. The workspace has menus and toolbars associated with it that become visible when the workspace is focused.
      Parameters:
      workspace - The ResourceWorkspace to register with the designer
    • getResourceMetaRegistry

      @NonNull DesignerResourceMetaRegistry getResourceMetaRegistry()
      Returns the registry of resource type metadata contributed by installed modules.
    • getAiContext

      @NonNull Optional<DesignerAiContext> getAiContext()
      Returns the Designer's AI context — exposes toolbar-button factories for inline chat popups and the currently selected model provider. Only present when the AI module is installed and AI is enabled in this Designer.
    • addPropertyEditor

      void addPropertyEditor(@NonNull Class<? extends AbstractPropertyEditorPanel> pageClass)
      Adds a property editor page that will be incorporated into the Designer's project property editing system. This class will be instantiated the first time that the property editor is displayed, and must have either a nullary constructor or a constructor that takes a DesignerContext.

      The Property Editing framework is designed around the idea that modules will store properties in opaquely xml-serialized project resources which can be uniquely identified by their module ID and resource type. The property editing UI will handle the de/serialization and project syncing tasks so that the property editor pages can simply focus on UI.

    • registerSearchProvider

      void registerSearchProvider(@NonNull SearchProvider provider)
      Registers a search provider that will be exposed through the find/replace system.
    • getSearchProviders

      @NonNull List<SearchProvider> getSearchProviders()
      Get the registered SearchProviders.
      Returns:
      Not null.
    • getSearchProvider

      @Nullable SearchProvider getSearchProvider(String id)
    • registerClientPermissions

      void registerClientPermissions(Map<String,String> bundleMap)
      Register id-bundlekey pairs to limit client permissions
      Parameters:
      bundleMap - Map of ids to bundlekeys. Not null.
    • getClientPermissionBundleKeys

      @NonNull Map<String,String> getClientPermissionBundleKeys()
    • getProject

      DesignableProject getProject()
      Description copied from interface: ClientContext
      Returns the project that this client is running. Note that this may be null before the client is fully logged in and started, because the context is created before the project is downloaded.
      Specified by:
      getProject in interface ClientContext
    • canEditResourceProtection

      boolean canEditResourceProtection()
      Checks whether or not the current logged in user can edit the protection bits of project resources.