Element: FeatureGroupRef

Description

Create a reference to a FeatureGroup in another Fragment.

Derived By

Restricting anyType

Attributes

Name	Type	Required?	Default	Description
Id	string	Yes		The identifier of the FeatureGroup to reference.
IgnoreParent	YesNoType	No		Normally feature group references that end up nested under a parent element create a connection to that parent.
Primary	YesNoType	No		Set this attribute to 'yes' in order to make the parent feature of this group the primary feature for any components and merges contained in the group.

Content Model

Always empty.

Referenced By

• Element Feature
• Element FeatureGroup
• Element FeatureRef

Definition

<xs:element name="FeatureGroupRef">
  <xs:annotation>
    <xs:documentation>Create a reference to a FeatureGroup in another Fragment.</xs:documentation>
    <xs:appinfo>
      <xse:seeAlso ref="FeatureGroup" xmlns:xse="http://schemas.microsoft.com/wix/2005/XmlSchemaExtension" />
    </xs:appinfo>
  </xs:annotation>
  <xs:complexType>
    <xs:attribute name="Id" type="xs:string" use="required">
      <xs:annotation>
        <xs:documentation>The identifier of the FeatureGroup to reference.</xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute name="IgnoreParent" type="YesNoType">
      <xs:annotation>
        <xs:documentation>
                    Normally feature group references that end up nested under a parent element create a 
                    connection to that parent. This behavior is undesirable when trying to simply reference
                    to a FeatureGroup in a different Fragment.  Specify 'yes' to have this feature group
                    reference not create a connection to its parent. The default is 'no'.
                </xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:attribute name="Primary" type="YesNoType">
      <xs:annotation>
        <xs:documentation>
                        Set this attribute to 'yes' in order to make the parent feature of this group
                        the primary feature for any components and merges contained in the group. 
                        Features may belong to multiple features.  By designating a feature as the 
                        primary feature of a component or merge, you ensure that whenever a component is 
                        selected for install-on-demand (IOD), the primary feature will be the one to install 
                        it.  This attribute should only be set if a component actually nests under multiple 
                        features.  If a component nests under only one feature, that feature is the primary 
                        feature for the component.  You cannot set more than one feature as the primary 
                        feature of a given component.
                    </xs:documentation>
      </xs:annotation>
    </xs:attribute>
    <xs:anyAttribute namespace="##other" processContents="lax">
      <xs:annotation>
        <xs:documentation>
                        Extensibility point in the WiX XML Schema.  Schema extensions can register additional
                        attributes at this point in the schema.
                    </xs:documentation>
      </xs:annotation>
    </xs:anyAttribute>
  </xs:complexType>
</xs:element>

---