Package org.eclipse.cdt.core

Interface ICExtensionReference

@Deprecated public interface ICExtensionReference
Deprecated.
replaced with ICConfigExtensionReference obtained from an ICConfigurationDescription
This is reference to ICExtension elements as stored in the Project Description. This has no notion of the ICConfigurationDescription, for that see ICConfigExtensionReference
See Also:
Restriction:
This interface is not intended to be referenced by clients.

  • Method Summary

    Modifier and Type
    Method
    Description
    ICExtension
    createExtension()
    Deprecated.
    Creates and returns a new instance of the cextension executable identified by the <run> attribute of the cextension.
    ICDescriptor
    getCDescriptor()
    Deprecated.
    Returns the project descriptor which this extension reference belongs to.
    String
    getExtension()
    Deprecated.
    Return the extension point of this reference.
    String
    getExtensionData(String key)
    Deprecated.
    Gets a value of the key from the .cdtproject file set by setExtensionData()
    org.eclipse.core.runtime.IConfigurationElement[]
    getExtensionElements()
    Deprecated.
    Returns all configuration elements that are children of the cextension element.
    String
    getID()
    Deprecated.
    Return the extension ID of this reference.
    void
    setExtensionData(String key, String value)
    Deprecated.
    Sets a name/value data pair on this reference in the .cdtproject file

  • Method Details

    • getExtension

      String getExtension()
      Deprecated.
      Return the extension point of this reference.
      Returns:
      String

    • getID

      String getID()
      Deprecated.
      Return the extension ID of this reference.
      Returns:
      String

    • setExtensionData

      void setExtensionData(String key, String value) throws org.eclipse.core.runtime.CoreException
      Deprecated.
      Sets a name/value data pair on this reference in the .cdtproject file
      Throws:
      org.eclipse.core.runtime.CoreException

    • getExtensionData

      String getExtensionData(String key)
      Deprecated.
      Gets a value of the key from the .cdtproject file set by setExtensionData()

    • getCDescriptor

      ICDescriptor getCDescriptor()
      Deprecated.
      Returns the project descriptor which this extension reference belongs to.
      Returns:
      the ICDescriptor

    • createExtension

      ICExtension createExtension() throws org.eclipse.core.runtime.CoreException
      Deprecated.
      Creates and returns a new instance of the cextension executable identified by the <run> attribute of the cextension.

      The ICExtension is instantiated using its 0-argument public constructor. If the class implements the org.eclipse.core.runtime.IExecutableExtension interface, the method setInitializationData is called, passing to the object the configuration information that was used to create it.

      Unlike other methods on this object, invoking this method may activate the plug-in.

      Returns:
      the executable ICExtension instance
      Throws:
      org.eclipse.core.runtime.CoreException - if an instance of the executable extension could not be created for any reason.
      See Also:
      • IExecutableExtension.setInitializationData(org.eclipse.core.runtime.IConfigurationElement, java.lang.String, java.lang.Object)

    • getExtensionElements

      org.eclipse.core.runtime.IConfigurationElement[] getExtensionElements() throws org.eclipse.core.runtime.CoreException
      Deprecated.
      Returns all configuration elements that are children of the cextension element. Returns an empty array if this configuration element has no children.

      Each child corresponds to a nested XML element in the configuration markup. For example, the configuration markup 

        <view>
      <verticalHint>top</verticalHint>
      <horizontalHint>left</horizontalHint>
  </view>
      corresponds to a configuration element, named "view", with two children.

      Returns:
      the child configuration elements
      Throws:
      org.eclipse.core.runtime.CoreException