Ensure minimum office versions are included on enums

CHANGELOG.md

@@ -6,6 +6,7 @@ and this project adheres to [Semantic Versioning](http://semver.org/spec/v2.0.0.
 
 ## Version 2.11.0 - Unreleased
 ### Added
+- Added minimum Office versions for enum types and values (#707).
 - Added `OpenXmlElementFunctionalExtensions.With` extension methods, which offer flexible means for constructing `OpenXmlElement` instances in the context of pure functional transformations.
 - Added additional `CompatSettingNameValues` values: `UseWord2013TrackBottomHyphenation`, `AllowHyphenationAtTrackBottom`, and `AllowTextAfterFloatingTableBreak` (#706).
 

src/DocumentFormat.OpenXml/Framework/OfficeAvailabilityAttribute.cs

@@ -10,7 +10,7 @@ namespace DocumentFormat.OpenXml
     /// <summary>
     /// Defines an OfficeAvailabilityAttribute class to indicate whether the property is available in a specific version of an Office application.
     /// </summary>
-    [AttributeUsage(AttributeTargets.Property | AttributeTargets.Class | AttributeTargets.Field)]
+    [AttributeUsage(AttributeTargets.Property | AttributeTargets.Class | AttributeTargets.Field | AttributeTargets.Enum)]
     public sealed class OfficeAvailabilityAttribute : Attribute, IOpenXmlSimpleTypeValidator
     {
         /// <summary>

src/DocumentFormat.OpenXml/GeneratedCode/schemas_microsoft_com_office_2009_07_customui.g.cs

@@ -15778,6 +15778,7 @@ public ContextMenus(string outerXml) : base(outerXml)
     /// <summary>
     /// Defines the GalleryShowInRibbonValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum GalleryShowInRibbonValues
     {
         ///<summary>
@@ -15797,6 +15798,7 @@ public enum GalleryShowInRibbonValues
     /// <summary>
     /// Defines the SizeValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum SizeValues
     {
         ///<summary>
@@ -15816,6 +15818,7 @@ public enum SizeValues
     /// <summary>
     /// Defines the ItemSizeValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum ItemSizeValues
     {
         ///<summary>
@@ -15835,6 +15838,7 @@ public enum ItemSizeValues
     /// <summary>
     /// Defines the BoxStyleValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum BoxStyleValues
     {
         ///<summary>
@@ -15854,6 +15858,7 @@ public enum BoxStyleValues
     /// <summary>
     /// Defines the TaskSizesValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum TaskSizesValues
     {
         ///<summary>
@@ -15897,6 +15902,7 @@ public enum TaskSizesValues
     /// <summary>
     /// Defines the ExpandValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum ExpandValues
     {
         ///<summary>
@@ -15958,6 +15964,7 @@ public enum ExpandValues
     /// <summary>
     /// Defines the StyleValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum StyleValues
     {
         ///<summary>
@@ -15983,6 +15990,7 @@ public enum StyleValues
     /// <summary>
     /// Defines the Style2Values enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum Style2Values
     {
         ///<summary>
@@ -16008,6 +16016,7 @@ public enum Style2Values
     /// <summary>
     /// Defines the LayoutChildrenValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum LayoutChildrenValues
     {
         ///<summary>

src/DocumentFormat.OpenXml/GeneratedCode/schemas_microsoft_com_office_drawing_2012_chartStyle.g.cs

@@ -5246,6 +5246,7 @@ public MarkerLayoutProperties() : base()
     /// <summary>
     /// Defines the ColorStyleMethodEnum enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum ColorStyleMethodEnum
     {
         ///<summary>
@@ -5283,6 +5284,7 @@ public enum ColorStyleMethodEnum
     /// <summary>
     /// Defines the StyleReferenceModifierEnum enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum StyleReferenceModifierEnum
     {
         ///<summary>
@@ -5296,6 +5298,7 @@ public enum StyleReferenceModifierEnum
     /// <summary>
     /// Defines the StyleColorEnum enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum StyleColorEnum
     {
         ///<summary>
@@ -5309,6 +5312,7 @@ public enum StyleColorEnum
     /// <summary>
     /// Defines the StyleEntryModifierEnum enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum StyleEntryModifierEnum
     {
         ///<summary>
@@ -5328,6 +5332,7 @@ public enum StyleEntryModifierEnum
     /// <summary>
     /// Defines the MarkerStyle enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum MarkerStyle
     {
         ///<summary>
@@ -5389,6 +5394,7 @@ public enum MarkerStyle
     /// <summary>
     /// Defines the Boolean enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum Boolean
     {
         ///<summary>
@@ -5414,6 +5420,7 @@ public enum Boolean
     /// <summary>
     /// Defines the TickMarkNinch enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum TickMarkNinch
     {
         ///<summary>
@@ -5451,6 +5458,7 @@ public enum TickMarkNinch
     /// <summary>
     /// Defines the TickLabelPositionNinch enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum TickLabelPositionNinch
     {
         ///<summary>
@@ -5488,6 +5496,7 @@ public enum TickLabelPositionNinch
     /// <summary>
     /// Defines the DataLabelsPosition enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum DataLabelsPosition
     {
         ///<summary>
@@ -5525,6 +5534,7 @@ public enum DataLabelsPosition
     /// <summary>
     /// Defines the LegendPosition enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum LegendPosition
     {
         ///<summary>
@@ -5562,6 +5572,7 @@ public enum LegendPosition
     /// <summary>
     /// Defines the TitlePosition enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum TitlePosition
     {
         ///<summary>

src/DocumentFormat.OpenXml/GeneratedCode/schemas_microsoft_com_office_drawing_2012_main.g.cs

@@ -261,6 +261,7 @@ public SignatureLine() : base()
     /// <summary>
     /// Defines the TargetScreenSize enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2013)]
     public enum TargetScreenSize
     {
         ///<summary>

src/DocumentFormat.OpenXml/GeneratedCode/schemas_microsoft_com_office_drawing_2014_chartex.g.cs

@@ -4996,6 +4996,7 @@ public NumericLevel(string outerXml) : base(outerXml)
     /// <summary>
     /// Defines the FormulaDirection enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum FormulaDirection
     {
         ///<summary>
@@ -5015,6 +5016,7 @@ public enum FormulaDirection
     /// <summary>
     /// Defines the StringDimensionType enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum StringDimensionType
     {
         ///<summary>
@@ -5028,6 +5030,7 @@ public enum StringDimensionType
     /// <summary>
     /// Defines the NumericDimensionType enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum NumericDimensionType
     {
         ///<summary>
@@ -5059,6 +5062,7 @@ public enum NumericDimensionType
     /// <summary>
     /// Defines the SidePos enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum SidePos
     {
         ///<summary>
@@ -5090,6 +5094,7 @@ public enum SidePos
     /// <summary>
     /// Defines the PosAlign enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum PosAlign
     {
         ///<summary>
@@ -5115,6 +5120,7 @@ public enum PosAlign
     /// <summary>
     /// Defines the AxisUnit enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum AxisUnit
     {
         ///<summary>
@@ -5182,6 +5188,7 @@ public enum AxisUnit
     /// <summary>
     /// Defines the TickMarksType enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum TickMarksType
     {
         ///<summary>
@@ -5213,6 +5220,7 @@ public enum TickMarksType
     /// <summary>
     /// Defines the SeriesLayout enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum SeriesLayout
     {
         ///<summary>
@@ -5256,6 +5264,7 @@ public enum SeriesLayout
     /// <summary>
     /// Defines the ParentLabelLayoutVal enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum ParentLabelLayoutVal
     {
         ///<summary>
@@ -5281,6 +5290,7 @@ public enum ParentLabelLayoutVal
     /// <summary>
     /// Defines the IntervalClosedSide enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum IntervalClosedSide
     {
         ///<summary>
@@ -5300,6 +5310,7 @@ public enum IntervalClosedSide
     /// <summary>
     /// Defines the QuartileMethod enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum QuartileMethod
     {
         ///<summary>
@@ -5319,6 +5330,7 @@ public enum QuartileMethod
     /// <summary>
     /// Defines the DataLabelPos enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum DataLabelPos
     {
         ///<summary>
@@ -5380,6 +5392,7 @@ public enum DataLabelPos
     /// <summary>
     /// Defines the PageOrientation enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2016)]
     public enum PageOrientation
     {
         ///<summary>

src/DocumentFormat.OpenXml/GeneratedCode/schemas_microsoft_com_office_powerpoint_2010_main.g.cs

@@ -2977,6 +2977,7 @@ public NullEventRecord() : base()
     /// <summary>
     /// Defines the TransitionPatternValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum TransitionPatternValues
     {
         ///<summary>
@@ -2996,6 +2997,7 @@ public enum TransitionPatternValues
     /// <summary>
     /// Defines the TransitionCenterDirectionTypeValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum TransitionCenterDirectionTypeValues
     {
         ///<summary>
@@ -3009,6 +3011,7 @@ public enum TransitionCenterDirectionTypeValues
     /// <summary>
     /// Defines the TransitionShredPatternValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum TransitionShredPatternValues
     {
         ///<summary>
@@ -3028,6 +3031,7 @@ public enum TransitionShredPatternValues
     /// <summary>
     /// Defines the TransitionLeftRightDirectionTypeValues enumeration.
     /// </summary>
+    [OfficeAvailability(FileFormatVersions.Office2010)]
     public enum TransitionLeftRightDirectionTypeValues
     {
         ///<summary>