// Licensed to the .NET Foundation under one or more agreements.
// The .NET Foundation licenses this file to you under the MIT license.
// See the LICENSE file in the project root for more information.
 
namespace Microsoft.VisualStudio.LanguageServices.Xaml.Features.Completion
{
    /// <summary>
    /// An enum to identify what kind of completion a given Completion
    /// represents.
    /// </summary>
 
    public enum XamlCompletionKind
    {
        /// <summary>
        /// The completion represents a value.
        /// </summary>
        Element,
 
        /// <summary>
        /// The completion represents an attribute.
        /// </summary>
        Attribute,
 
        /// <summary>
        /// The completion represents an attribute value.
        /// </summary>
        Value,
 
        /// <summary>
        /// The completion represents a property element.
        /// </summary>
        PropertyElement,
 
        /// <summary>
        /// The completion represents a XML namespace prefix.
        /// </summary>
        Prefix,
 
        /// <summary>
        /// The completion represents a an event.
        /// </summary>
        Event,
 
        /// <summary>
        /// The completion represents a comment;
        /// </summary>
        Comment,
 
        /// <summary>
        /// This completion represents a CDATA
        /// </summary>
        CData,
 
        /// <summary>
        /// The completion represents a processing instruction.
        /// </summary>
        ProcessingInstruction,
 
        /// <summary>
        /// The completion represents an end tag.
        /// </summary>
        EndTag,
 
        /// <summary>
        /// The completion represents a type prefix for an attached property 
        /// or property elements (i.e. "Grid.").
        /// </summary>
        TypePrefix,
 
        /// <summary>
        /// The completion is returned for event handler values indicating
        /// that the language service expects the name of an event handler.
        /// The description of the event handler is found in 
        /// EventDescription property.
        /// </summary>
        EventHandlerDescription,
 
        /// <summary>
        /// The completion represents the type of a MarkupExtension.
        /// </summary>
        MarkupExtensionClass,
 
        /// <summary>
        /// The completion represents the name of a MarkupExtension parameter.
        /// </summary>
        MarkupExtensionParameter,
 
        /// <summary>
        /// The completion represents the value of a MarkupExtension parameter.
        /// </summary>
        MarkupExtensionValue,
 
        /// <summary>
        /// The completion represents a type for an attached property in the Property Completion.
        /// (i.e. "Grid.").
        /// </summary>
        Type,
 
        /// <summary>
        /// The completion represents a value for Property attribute in Styles. (These are direct DPs on TargetTypes).
        /// (i.e. "Grid.Background").
        /// </summary>
        PropertyValue,
 
        /// <summary>
        /// The completion represents a value for Property attribute in Styles. (These are APs on types).
        /// (i.e. "Grid.Row").
        /// </summary>
        AttachedPropertyValue,
 
        /// <summary>
        /// The completion represents a type  within for Property attribute in Styles. (These are the types that for APs).
        /// (i.e. "Grid.Row").
        /// </summary>
        AttachedPropertyTypePrefix,
 
        /// <summary>
        /// The completion represents a local resource.
        /// </summary>
        LocalResource,
 
        /// <summary>
        /// The completion represents a system resource.
        /// </summary>
        SystemResource,
 
        /// <summary>
        /// The completion represents a property from the schema generated from a data source.
        /// </summary>
        DataBoundProperty,
 
        /// <summary>
        /// The completion represents the name of an element in the current scope.
        /// </summary>
        ElementName,
 
        /// <summary>
        /// The completion represents a namespace value. For instance, xmlns:local="Completion"
        /// </summary>
        NamespaceValue,
 
        /// <summary>
        /// The completion represents a condition value in a namespace. For instance, xmlns:local="namespace?Completion"
        /// </summary>
        ConditionValue,
 
        /// <summary>
        /// The completion represents a conditional argument value in a namespace. For instance, xmlns:local="namespace?Condition(Completion)"
        /// </summary>
        ConditionalArgument,
 
        /// <summary>
        /// A completion that cannot legally be used, but is shown for sake of user-education or
        /// completeness. Example would be the phone Pivot control in a shared Mercury XAML file:
        /// this type cannot be legally used in a shared context, but we want to show it as it
        /// is a core phone type.
        /// </summary>
        Unusable,
 
        /// <summary>
        /// The completion represents #region for XAML
        /// </summary>
        RegionStart,
 
        /// <summary>
        /// The completion represents #endregion for XAML
        /// </summary>
        RegionEnd,
 
        /// <summary>
        /// The completion represents a snippet for XAML
        /// </summary>
        Snippet,
 
        /// <summary>
        /// The completion represents a method
        /// </summary>
        Method,
    }
}