TagVisualization Class

Represents content that appears in a TagVisualizer control when a tagged object is put on a Microsoft Surface screen.

Namespace: Microsoft.Surface.Presentation.Controls
Assembly: Microsoft.Surface.Presentation (in Microsoft.Surface.Presentation)


public class TagVisualization : ContentControl, IManipulator
public class TagVisualization extends ContentControl implements IManipulator
public class TagVisualization extends ContentControl implements IManipulator

The TagVisualization object contains several properties that your application can initialize from the corresponding values of a TagVisualizationDefinition object:

Your application should not try to change the RenderTransform property of a TagVisualization object. This property is managed by the owning TagVisualizer object, and it is used to keep the visualization properly tracked to the tagged object.

For more information about how TagVisualizer, TagVisualization, and TagVisualizationDefinition work together to produce visible reactions to tagged objects, see TagVisualizationDefinition. For a simple code example, see Creating and Displaying Tag Visualizations.

TagVisualizer and TagVisualization Events

When a TagVisualizer control creates a TagVisualization object and adds it to the visual tree, the VisualizationAdded event is raised, followed by the GotTag event.

When the tagged physical object is removed from the Microsoft Surface screen, the TagVisualization raises the LostTag event. If the physical object is replaced on the surface that the TagVisualizer object controls before the time that is specified by LostTagTimeout has expired, the TagVisualization again raises the GotTag event. In this case, the TagVisualizer object does not raise the VisualizationAdded event again because the TagVisualization object is still contained in the visual tree.

When the tagged physical object is removed from the screen and remains off the screen beyond the expiration of LostTagTimeout, the TagVisualizer control removes the TagVisualization object from the visual tree and raises the VisualizationRemoved event.


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



Operating System (OS)Windows 7
Software Developer Kit (SDK)Surface 2.0
.NET Framework 4
Developer environmentVisual Studio 2010, Express or full edition
Microsoft Expression Blend 4.0 (optional)
End-user hardwareDevices made for Surface 2.0, or
Windows Touch computers

Did you find this information useful? Please send us your suggestions and comments.

© Microsoft Corporation. All rights reserved.