Skip to content

symbols-element.md

Latest commit

 

History

History
67 lines (51 loc) · 2.74 KB

symbols-element.md

File metadata and controls

67 lines (51 loc) · 2.74 KB
title Symbols Element
description The Symbols element defines GUIDs and IDs that are used by other VSCT elements. This article contains an example.
ms.date 11/04/2016
ms.topic reference
helpviewer_keywords
Symbols element (VSCT XML schema)
VSCT XML schema elements, Symbols
author tinaschrepfer
ms.author tinali
ms.subservice extensibility-integration

Symbols Element

Defines GUIDs and IDs that are used by other VSCT elements. For unmanaged code, this information typically comes from the header files that are specified by Extern Element. Managed code uses the child elements of the Symbols element to define this information.

If you create a .vsct file from an existing .cto file, the symbols will be generated as children of the Symbols element. For more information, see How to: Create a .Vsct File from an Existing .Cto File.

The Symbols element should not be confused with the Define Element, which defines name-value pairs for use by the preprocessor.

Syntax

<Symbols>
  <GuidSymbol>... </GuidSymbol>
  <GuidSymbol>... </GuidSymbol>
</Symbols>

Attributes and Elements

The following sections describe attributes, child elements, and parent elements.

Attributes

Attribute Description
None

Child Elements

Element Description
GuidSymbol Defines a GUID symbol. GuidSymbol has two required attributes: name and value. The name is the name of the symbol, and the value is the value of the GUID as a string.

For example:<GuidSymbol name="guidVsPackage1Pkg" value="{c5f54698-101a-4846-84d3-dc748f9cd848}" />
IDSymbol Defines a symbol. IDSymbol has two required attributes: name and value. The name is the name of the symbol, and the value is the value of the symbol as a string.

For example:<IDSymbol name="MyMenuGroup" value="0x1020" />

Parent Elements

Element Description
CommandTable Element The root element of the .vsct file.

Example

<Symbols>
  <GuidSymbol name="guidVsPackage1Pkg" value="{c5f54698-101a-4846-84d3-dc748f9cd848}" />
  <GuidSymbol name="guidVsPackage1CmdSet" value="{cb9dfd7f-2fcc-4a3e-aae8-f7fe30b1cfac}">
    <IDSymbol name="MyMenuGroup" value="0x1020" />
    <IDSymbol name="cmdidMyCommand" value="0x0100" />
    <IDSymbol name="cmdidMyTool" value="0x0101" />
  </GuidSymbol>
</Symbols>

See also