MarkerFormatDefinition Class

Provides coloring information for text markers.

Inheritance Hierarchy

System.Object
  Microsoft.VisualStudio.Text.Classification.EditorFormatDefinition
    Microsoft.VisualStudio.Text.Classification.MarkerFormatDefinition

Namespace:  Microsoft.VisualStudio.Text.Classification
Assembly:  Microsoft.VisualStudio.Text.UI.Wpf (in Microsoft.VisualStudio.Text.UI.Wpf.dll)

Syntax

'Declaration
Public MustInherit Class MarkerFormatDefinition _
    Inherits EditorFormatDefinition

public abstract class MarkerFormatDefinition : EditorFormatDefinition

public ref class MarkerFormatDefinition abstract : public EditorFormatDefinition

[<AbstractClass>]
type MarkerFormatDefinition =  
    class 
        inherit EditorFormatDefinition 
    end

public abstract class MarkerFormatDefinition extends EditorFormatDefinition

The MarkerFormatDefinition type exposes the following members.

Constructors

	Name	Description
	MarkerFormatDefinition	Initializes a new instance of MarkerFormatDefinition.

Top

Properties

	Name	Description
	BackgroundBrush	Gets or sets the background brush for this item. (Inherited from EditorFormatDefinition.)
	BackgroundColor	Gets or sets the background color for this item. (Inherited from EditorFormatDefinition.)
	BackgroundCustomizable	Determines whether the background of this format is customizable. (Inherited from EditorFormatDefinition.)
	Border	The pen is used to draw the border of the text marker.
	DisplayName	Defines the string used when displaying this format definition to the user. This property is used only if the UserVisibleAttribute is set to true on this object's export. (Inherited from EditorFormatDefinition.)
	Fill	The brush is used to paint the inner body of the text marker.
	ForegroundBrush	Gets or sets the foreground brush for this item. (Inherited from EditorFormatDefinition.)
	ForegroundColor	Gets or sets the foreground color for this item. (Inherited from EditorFormatDefinition.)
	ForegroundCustomizable	Determines whether the foreground of this format is customizable. (Inherited from EditorFormatDefinition.)
	ZOrder	Represents the Z-order of the marker when it is drawn on the text marker adornment layer.

Top

Methods

	Name	Description
	CreateResourceDictionary	Creates a ResourceDictionary from this definition. (Inherited from EditorFormatDefinition.)
	CreateResourceDictionaryFromDefinition	Creates a ResourceDictionary using this definition. (Overrides EditorFormatDefinition.CreateResourceDictionaryFromDefinition().)
	Equals	Determines whether the specified object is equal to the current object. (Inherited from Object.)
	Finalize	Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection. (Inherited from Object.)
	GetHashCode	Serves as a hash function for a particular type. (Inherited from Object.)
	GetType	Gets the Type of the current instance. (Inherited from Object.)
	MemberwiseClone	Creates a shallow copy of the current Object. (Inherited from Object.)
	ToString	Returns a string that represents the current object. (Inherited from Object.)

Top

Fields

	Name	Description
	BorderId	The string used to look up the border pen value in the ResourceDictionary.
	FillId	The string used to lookup the fill brush value in the ResourceDictionary.
	ZOrderId	The string used to lookup the z-order value in the ResourceDictionary.

Top

Remarks

This is a MEF component part, and should be exported as: [Export(typeof(EditorFormatDefinition))] 

Exporters must provide the attribute NameAttribute.

The MarkerFormatDefinition is consumed by the default visual manager for the TextMarkerTag. The Type property should correspond to the NameAttribute of this export so that the desired color can be correctly loaded for the text marker.

Examples

For an example of creating a marker format definition, see Walkthrough: Highlighting Text.

Thread Safety

Any public static (Shared in Visual Basic) members of this type are thread safe. Any instance members are not guaranteed to be thread safe.

See Also

Reference

Microsoft.VisualStudio.Text.Classification Namespace