Referenz für Components-Elemente

Mehrere Components-Elemente können verwendet werden, um die Komponenten für ein Plugin anzugeben; jedes Components-Element kann eine oder mehrere Komponenten angeben. Plattform- und Produktinformationen für ein Components-Element werden durch das RuntimeRequirements-Element definiert.

Wenn alle innerhalb eines Components-Elements definierten Komponenten für dieselbe Plattform gelten, ist es nicht erforderlich, jedem ComponentEntry-Element ein RuntimeRequirements-Element hinzuzufügen.

Zusammen mit dem RuntimeRequirements-Element kann das Components-Element eines oder mehrere der folgenden Elemente enthalten.

ComponentEntry
RegistryEntries
SystemVariables
EnvironmentVariables

Anmerkung: Ein Components-Element kann nur über ein RegistryEntries-, SystemVariables-und EnvironmentVariables-Elemente verfügen, kann jedoch mehrere ComponentEntry-Elemente enthalten.

Nachfolgend werden die grundlegenden Beziehungen zwischen dem Components-Element und den Elementen dargestellt, die es enthalten kann.

<Components>
  <RuntimeRequirements ... />

  <RegistryEntries>
    <RegistryEntry ... />
  </RegistryEntries>

  <SystemVariables>
    <SystemVariable ... />
  </SystemVariables>

  <EnvironmentVariables>
    <EnvironmentVariable ... />
  </EnvironmentVariables>

  <ComponentEntry ... >
    <RuntimeRequirements ... />

    <AssemblyMappings>
      <AssemblyMapping ... />
      <AssemblyMappingFolder ... />
    </AssemblyMappings>

    <Commands ...>
      <Command ... />
    </Commands>
  </ComponentEntry>

  <ComponentEntry ... />
</Components>

ComponentEntry-Element (AutoCAD 2013 und auf höheren Versionen basierende Produkte)

Das ComponentEntry-Element ist erforderlich und wird verwendet, um Details über die einzelnen Komponenten im Components-Element anzugeben.

Sie können so viele ComponentEntry-Elemente wie nötig angeben. Zu den Komponenten-Typen gehören folgende Dateiformate:

Windows und Mac OS

AutoLISP (LSP)
AutoLISP Fastload (FAS)
ObjectARX (ARX)
ObjectDBX (DBX)

Nur Windows

Kompiliertes AutoLISP-Projekt/Visual LISP (VLX)
Extensible Application Markup Language (XAML)
JavaScript (JS)
.NET Assembly (DLL, verwalteter oder gemischter Modus)
Partielle Anpassung (CUI-/CUIx)
Werkzeugpalette (ATC)
VBA-Projekt (DVB)

Ein ComponentEntry-Element kann ein Commands-Element enthalten, wenn das LoadReasons-Attribut auf LoadOnCommandInvocation gesetzt ist.

Anmerkung: ComponentEntry-Elemente werden in der Reihenfolge geladen, in der sie aufgeführt werden, jedoch von unten nach oben. Daher müssen alle Dateien, die von anderen Komponenten abhängen, sich weiter unten auf der Liste befinden. Wenn zum Beispiel ein ObjectARX-Modul von einem ObjectDBX-Modul abhängig ist, muss das ObjectARX-Modul in der Liste über dem ObjectDBX-Modul erscheinen.

Ein ComponentEntry-Element kann mit beliebig vielen der folgenden Attribute verknüpft sein:

Attribut	Beschreibung
AppName	Optional für AutoLISP; erforderlich für ObjectARX und .NET - Komponentenname; entspricht `AppName` in der ObjectARX API AcadAppInfo-Klasse.
AppDescription	Komponentenbeschreibung; entspricht `AppDescription` in der ObjectARX API AcadAppInfo-Klasse.
AppType	Komponententyp; überschreibt den Typ, der von der Dateierweiterung abgeleitet wird, die im Attribut `ModuleName` bereitgestellt wird. Beim Komponententyp kann es sich um einen der Folgenden handeln: .Net – .NET Assembly (verwaltet oder gemischt) Arx – ObjectARX Anmerkung: Erforderlich zum Laden einer ARX-Datei aus einem Paket in AutoCAD für Mac. Atc – Werkzeugpalette Bundle – Bundle-Paket Cui oder CuiX – partielle Anpassung Dbx – ObjectDBX Abhängigkeit – DLL-Ressourcendatei (kann nicht in das AutoCAD-basierte Produkt geladen werden) JavaScript – JavaScript Lisp oder CompiledLisp – AutoLISP/Visual LISP Mnu – Menüanpassung VBA – VBA-Projekt Xaml – XAML-Datei, die zum Implementieren einer kontextabhängigen Registerkarte der Multifunktionsleiste verwendet wird
ModuleName	Relativer Pfad zur Komponente innerhalb des Pakets; entspricht `ModuleName` in der ObjectARX API AcadAppInfo-Klasse. Der Komponenten-Typ wird durch die Dateierweiterung ermittelt: .atc - Werkzeugpalette .arx – ObjectARX .cuix – Partielle Anpassung .dbx – ObjectDBX .dll – .NET Assembly (verwaltet) .dvb – VBA-Projekt (AutoCAD 2015-basierte Produkte und höher) Anmerkung: Für DVB-Dateien muss zuerst der VBA-Aktivierer installiert werden. Nach dem Laden muss der Benutzer auf Makros aktivieren klicken, bevor auf das Projekt und die zugehörigen Makros zugegriffen werden kann. Wichtig: Derzeit können VBA-Projektdateien nur geladen werden, wenn eine Zeichnungsdatei beim Start geöffnet ist. Dazu stellen Sie die Systemvariable STARTUP auf den Wert 0 oder 1 ein. .js – JavaScript (Produkte, die auf AutoCAD 2015 und neueren Versionen basieren) .lsp, .fas oder .vlx – AutoLISP/Visual LISP .xaml – Extensible Application Markup Language (Produkte, die auf AutoCAD 2015 und neueren Versionen basieren) Anmerkung: Das Attribut `XamlType` muss auf ContextualTabRule eingestellt sein. Wenn Ihre Anwendung mehrere Sprachen unterstützt, können unterschiedliche Versionen einer bestimmten Komponente angegeben werden, indem `ModuleName` mit einem Ländercode kombiniert wird. Eine vollständige Liste der unterstützten Ländercodes finden Sie unter "Unterstützte Ländercodes - Referenz". Anmerkung: Alle Pfad-Spezifikationssymbole lauten / und nicht \ und Pfade sind relativ zum .bundle-Stammordner.
PerDocument	Nur AutoLISP - Wenn Wahr, wird die AutoLISP-Datei einmal pro Dokument geladen. Der Vorgabewert ist Wahr.
Loadreasons	Mehrere Werte können angegeben werden - Definiert die Parameter des Ladeverhaltens für die Komponente mit `LoadReasons` sowie die Ausnahme des Parameters `LoadOnCommandInvocation`. Vorgabemäßig sind `LoadOnAutoCADStartup`, `LoadOnAppearance` und `LoadOnProxy` aktiviert (auf True gesetzt), wenn `LoadReasons` nicht angegeben ist. Wenn die Parameter deaktiviert werden (auf False gesetzt), muss das `LoadReasons`-Element zusammen mit den auf False gesetzten Parametern angegeben werden. Vorgabemäßig ist `LoadOnCommandInvocation` deaktiviert. Wenn dieser Parameter aktiviert wird, werden `LoadOnAutoCADStartup` und `LoadOnAppearance` deaktiviert, sofern sie nicht ausdrücklich aktiviert werden. Wenn eines oder mehrere Befehlselemente als Teil des Komponentenelements definiert sind, ist `LoadOnCommandInvocation` implizit aktiviert. Weitere Informationen zu AcadAppInfo LoadReasons finden Sie im ObjectARX Reference Guide. Gültige Parameterwerte: Wahr - Parameter ist aktiviert Falsch - Parameter ist deaktiviert Die folgenden Parameter sind verfügbar: LoadOnCommandInvocation. Wird nur geladen, wenn ein benutzerdefinierter Befehl aufgerufen wird. Bei Verwendung dieses Parameters muss ein Befehlselement mitgeliefert werden. Wenn `LoadOnCommandInvocation` aktiviert ist, wird davon ausgegangen, dass `LoadOnAutoCADStartup` und `LoadOnAppearance` deaktiviert sind, es sei denn, diese werden explizit aktiviert. Gilt nur für AutoLISP-, ObjectARX- und .NET-Dateien. Anmerkung: Zum Zwecke der Leistung beim Start ist es sehr wichtig, diese Option zu verwenden, wenn durch Ihre Komponenten Befehle definiert werden. LoadOnAutoCADStartup. Wird geladen, wenn das AutoCAD-basierte Produkt gestartet wird. Wenn angegeben, hat dieser Parameter Vorrang vor allen anderen Parametern. `LoadOnAutoCADStartup` sollte nur verwendet werden, wenn keiner der anderen Parameter geeignet ist. Deaktivieren Sie ihn (auf False setzen), wenn möglich. Wenn der Parameter `LoadOnAutoCADStartup` ausgelassen wird, wird er vorgabemäßig aktiviert (auf True gesetzt), es sei denn, `LoadOnCommandInvocation` ist aktiviert. In diesem Fall wird `LoadOnAutoCADStartup` vorgabemäßig auf False gesetzt. Gilt nur für VBA-Projekt-, ObjectARX- und .NET-Dateien. LoadOnProxy. Wird geladen, wenn ein Platzhalter für ein benutzerdefiniertes Objekt erkannt wird. Dieser Parameter wird standardmäßig aktiviert, wenn er nicht explizit deaktiviert (auf Falsch gesetzt) wird. Wenn aktiviert (auf True gesetzt), sollte `LoadOnAutoCADStartup` deaktiviert sein. Gilt nur für ObjectDBX-Dateien. LoadOnAppearance. Wird geladen, wenn das Produkt das Anwendungspaket in einem der ApplicationPlugins-Ordner erkennt. Dies ermöglicht das sofortige Laden bei der Installation, sodass das AutoCAD-basierte Produkt nicht neu gestartet werden muss. Der Parameter verhält sich wie `LoadOnAutoCADStartup`, außer dass der Ladekontext relevant ist, wenn eine Anwendung während der Ausführung des Produkts installiert wird, z. B. beim Installieren über die Autodesk App Store-Website.
XamlType	XAML-Typ; derzeit wird nur der Wert ContextualTabRule unterstützt, der erforderlich ist, wenn eine XAML-Datei dem Attribut `ModuleName` zugewiesen wird. Die Anwendungsdatei, die die XAML-Datei verwendet, sollte nach dem `ComponentEntry`-Element mit der XAML-Datei aufgeführt werden.

Commands-Element – (auf AutoCAD 2013 und höherenVersionen basierende Produkte)

Das Commands-Element ist optional, es sei denn, der LoadOnCommandInvocation-Parameter ist für das LoadReasons-Attribut aktiviert. Wird zur Angabe der Befehle verwendet, die für LoadOnCommandInvocation registriert werden sollen.

Sie können so viele Command-Elemente wie nötig angeben.

Einem Commands-Element können folgende Attribute zugeordnet sein:

Attribut	Beschreibung
GroupName	Name, der verwendet wird, um zugehörige Befehle zu organisieren.

Commands-Element – (auf AutoCAD 2013 und höheren Versionen basierende Produkte)

Legt den globalen und lokalen Namen für jeden Befehl fest.

Einem Command-Element können beliebig viele der folgenden Attribute zugeordnet sein:

Attribut	Beschreibung
Global	Globaler Befehlsname.
Local	Lokaler Befehlsname. Befehle können für mehrere Sprachen definiert werden, indem `Local` mit einem Ländercode kombiniert wird. Eine vollständige Liste der unterstützten Ländercodes finden Sie unter "Unterstützte Ländercodes - Referenz".
HelpTopic	Hilfethema, das geöffnet wird, wenn der Befehl aktiv ist und die Taste F1 gedrückt wird. Anmerkung: Damit das Hilfethema angezeigt wird, muss dem Plugin eine Hilfedatei zugewiesen sein. Der Speicherort der Hilfedatei für das Plugin wird unter dem `ApplicationPackage`-Element mit dem Attribut `HelpFile` angegeben.
StartupCommand	Führt den Befehl beim Start aus, wenn wahr.

Im folgenden Beispiel werden zwei Befehle hinzugefügt, die in einer Gruppe namens ADSKCMDS definiert sind:

<Commands GroupName="ADSKCMDS">
    <Command Global="HELLOWORLD" Local="ADSKHELLOWORLD"/>
    <Command Global="DRAWLINE" Local="ADSKDRAWLINE"/>
</Commands>

AssemblyMappings-Element (auf AutoCAD 2013 und höheren Versionen basierende Produkte)

Das AssemblyMappings-Element ist optional und kann eines oder mehrere AssemblyMappings- bzw. AssemblyMappingFolder-Elemente enthalten. AssemblyMapping- und AssemblyMappingFolder-Elemente werden verwendet, um Baugruppendateien und Ordnerpfade zu internen Listen hinzuzufügen, die von AutoCAD zum Auflösen von Baugruppen verwendet werden, die sich nicht im Installationsordner des Produkts befinden.

AssemblyMapping-Element (auf AutoCAD 2013 und höheren Versionen basierende Produkte)
Attribut	Beschreibung
Name	Name des `ComponentEntry`-Elements, mit dem die Baugruppe verknüpft ist und mit dem sie geladen werden soll.
Path	Relativer Pfad zur Baugruppe innerhalb des Pakets.

AssemblyMappingFolder-Element (auf AutoCAD 2022 und höheren Versionen basierende Produkte)
Attribut	Beschreibung
Path	Relativer Pfad zu den Baugruppen innerhalb des Pakets.

Im folgenden Beispiel werden zwei Ordner hinzugefügt, die Baugruppen enthalten, die von einer Komponente verwendet werden:

<AssemblyMappings>
    <AssemblyMappingFolder Path="./Content/Assemblies" />
    <AssemblyMappingFolder Path="./Content/MoreAssemblies" />
</AssemblyMappings>

RegistryEntries-Element (auf AutoCAD 2015-basierende Produkte und höher)

Das RegistryEntries-Element ist optional und kann eines oder mehrere RegistryEntry-Elemente enthalten. Ein RegistryEntry-Element enthält die Definition eines Registrierungseintrags, den das Plugin erstellen oder ändern soll. Registrierungseinträge werden in der Windows-Registrierung oder in einer Eigenschaftenliste (PLIST) unter Mac OS gespeichert.

Anmerkung: Unter Windows werden Registrierungseinträge unter HKEY_CURRENT_USER\Software\Autodesk\AutoCAD\<Version>ACAD-<Produktname>:<Sprache>. Es ist nicht möglich, Registrierungseinträge an anderen Positionen zu erstellen. Die entsprechende Position wird in den PLIST-Dateien unter Mac OS verwendet.

RegistryEntry-Element
Attribut	Beschreibung
Name	Name der Registrierungseintrags, der erstellt oder geändert werden soll.
Value	Wert, der dem Registrierungseintrag zugeordnet werden soll. Der Wert kann eines der optionalen Operator-Präfixe enthalten: `+`, `-`, `&` und `\|`. Weitere Informationen finden Sie im Abschnitt Operator-Präfixe für Variablenwert. Anmerkung: Das Operator-Präfix wird nicht beibehalten, wenn der Wert auf den Registrierungseintrag angewendet wird.
Type	Der Datentyp, der dem Registrierungseintrag zugeordnet werden soll. Beim Ändern eines vorhandenen Registrierungseintrags optional. Gültige Werte sind: REG_SZ – Zeichenfolge; mit Null beendet REG_EXPAND_SZ – Zeichenfolge, die eine ausgeblendete Umgebungsvariable enthält, z. B. APPDATA%; mit Null beendet REG_DWORD – 32-Bit-Ganzzahl ohne Vorzeichen REG_QWORD – 64-Bit Ganzzahl mit Vorzeichen Wenn ein Operator-Präfix als Teil der Registrierungseintrags verwendet wird, muss der entsprechende Datentyp angegeben werden. Wenn die entsprechende Datentyp nicht verwendet wird, wird der Vorgang wird als Zeichenfolge-Operation behandelt.
Flags	Optional, Flags für Erstellen und Ändern. Mehrere Flags können angegeben werden; verwenden Sie einen senkrechten Strich (Pipe-Symbol), um die Flags voneinander zu trennen. Die folgenden Flags werden unterstützt: Create – Der Registrierungseintrag wird erstellt, wenn er noch nicht vorhanden ist. (Vorgabe) Open – Der Wert der Registrierungseintrag wird jedes Mal geändert, wenn das Plugin geladen wird, und nur dann, wenn der Registrierungseintrag vorhanden ist. OpenOnce – Der Wert der Registrierungseintrag wird beim allerersten Laden des Plugins geändert, und nur dann, wenn der Registrierungseintrag vorhanden ist. Wenn das Plugin deinstalliert und erneut installiert wird, bewirkt dies, dass der Wert des Registrierungseintrags erneut geändert wird. Anmerkung: Das Flag Open oder OpenOnce muss verwendet werden, um den Wert eines Registrierungseintrags zu ändern.

Im folgenden Beispiel wird die Registrierungsschlüssel MYREGKEY erstellt und die Werte STRING und NUMBER werden hinzugefügt:

<RegistryEntries>
    <RegistryEntry
        Key="MYREGKEY"
        Name="STRING"
        Value="Example"
        Type="REG_SZ"
    />

    <RegistryEntry
        Key="MYREGKEY"
        Name="NUMBER"
        Value="123"
        Type="REG_DWORD"
    />
</RegistryEntries>

SystemVariables-Element (auf AutoCAD 2015-basierende Produkte und höher)

Das SystemVariables-Element ist optional und kann ein oder mehrere SystemVariables-Elemente enthalten. Ein SystemVariables-Element enthält die Definition einer Systemvariablen, die das Plugin erstellen oder ändern soll.

SystemVariable-Element
Attribut	Beschreibung
Name	Name der Systemvariablen, die erstellt oder geändert werden soll.
Value	Wert, der der Variable zugeordnet werden soll. Der Wert kann eines der optionalen Operator-Präfixe enthalten: `+`, `-`, `&` und `\|`. Weitere Informationen finden Sie im Abschnitt Operator-Präfixe für Variablenwert. Anmerkung: Das Operator-Präfix wird nicht beibehalten, wenn der Wert auf die Variable angewendet wird.
PrimaryType	Der Datentyp, der der Variable zugeordnet werden soll. Optional beim Ändern einer vorhandenen Systemvariable. Gültige Werte sind: Int16 – 16-Bit-Ganzzahl mit Vorzeichen Int32 – 32-Bit-Ganzzahl Real – Gleitkommazahl oder doppelter numerischer Wert String – Einzelzeichen oder mehrere Zeichen Wenn ein Operator-Präfix als Teil des Variablenwerts verwendet wird, muss der entsprechende Datentyp angegeben werden. Wenn die entsprechende Datentyp nicht verwendet wird, wird der Vorgang wird als Zeichenfolge-Operation behandelt.
StorageType	Speicherort für den Wert der Variablen; wenn beibehalten. . Optional beim Ändern einer vorhandenen Systemvariable. Gültige Werte sind: Database – Beibehalten in der Zeichnungsdatei, in der die Variable erstellt wird Profile – Beibehalten als Teil des aktuellen AutoCAD-Profils Session – Nicht beibehalten zwischen Sitzungen oder in der Zeichnung, in der die Variable erstellt wird User – Beibehalten als Teil des FixedProfile für AutoCAD
Owner	Optional, AcRX Service Name. Wird verwendet, um Schreibschutz für eine Systemvariable festzulegen, sodass sie nur durch die Anwendung geändert werden kann, die den Service Name mit `acrxRegisterService()` registriert.
Flags	Optional, Flags für Erstellen und Ändern. Mehrere Flags können angegeben werden; verwenden Sie einen senkrechten Strich (Pipe-Symbol), um die Flags voneinander zu trennen. Die folgenden Flags werden unterstützt: Create – Die Variable wird erstellt, wenn sie noch nicht vorhanden ist. (Vorgabe) Open – Der Wert der Variable wird jedes Mal geändert, wenn das Plugin geladen wird, und nur dann, wenn die Variable vorhanden ist. OpenOnce – Der Wert der Variable wird beim allerersten Laden des Plugins geändert, und nur dann, wenn die Variable vorhanden ist. Wenn das Plugin deinstalliert und erneut installiert wird, bewirkt dies, dass der Wert der Variablen erneut geändert wird. SpacesAllowed – Erlaubt, dass die LEERTASTE in der Befehlszeile gedrückt wird. Wenn nicht angegeben, hat das Drücken der LEERTASTE wird die gleiche Funktion wie das Drücken der EINGABETASTE. Anmerkung: Verwenden Sie dies nur mit dem Flag Create und wenn für das Attribut `PrimaryType` String eingestellt ist. DotIsEmpty – Ermöglicht das Löschen des Werts einer Variable durch Eingabe eines Punkts (.). (Punkt) für den Wert der Variablen. Anmerkung: Verwenden Sie dies nur mit dem Flag Create und wenn für das Attribut `PrimaryType` String eingestellt ist. NoUndo – Änderungen an der Variablen werden nicht aufgezeichnet und können mit den Befehlen Z oder ZURÜCK nicht rückgängig gemacht werden. Anmerkung: Verwenden Sie dies nur mit dem Flag Create. Chatty – Löst eine reactor-Benachrichtigung aus, auch wenn der Wert der Variablen auf ihren aktuellen Wert eingestellt ist. Anmerkung: Verwenden Sie dies nur mit dem Flag Create. Anmerkung: Das Flag Open oder OpenOnce muss verwendet werden, um den Wert einer Variablen zu ändern.

Im folgenden Beispiel wird eine benannte Systemvariable MYVARIABLE erstellt:

<SystemVariable
    Name="MYVARIABLE"
    PrimaryType="String"
    StorageType="User"
    Value="Example"
    Owner=""
    Flags="Create|DotIsEmpty|SpacesAllowed"
/>

Im folgenden Beispiel wird der Wert der Systemvariable CURSORSIZE in 100 geändert, wenn das Plugin zum ersten Mal geladen wird:

<SystemVariable
    Name="CURSORSIZE"
    Value="100"
    Flags="OpenOnce"
/>

EnvironmentVariables-Element (auf AutoCAD 2015-basierende Produkte und höher)

Das EnvironmentVariables-Element ist optional und kann ein oder mehrere EnvironmentVariable-Elemente enthalten. Ein EnvironmentVariable-Element enthält die Definition einer Umgebungsvariablen, die das Plugin erstellen oder ändern soll. Umgebungsvariablen werden in der Windows-Registrierung oder in einer Eigenschaftenliste (PLIST) unter Mac OS gespeichert.

Anmerkung: Der Wert der Umgebungsvariablen wird immer als Zeichenfolge gespeichert, und beim Namen einer Umgebungsvariablen wird zwischen Groß- und Kleinschreibung unterschieden.

EnvironmentVariable-Element
Attribut	Beschreibung
Name	Name der Umgebungsvariablen, die erstellt oder geändert werden soll.
Value	Wert, der der Variable zugeordnet werden soll. Der Wert kann eines der optionalen Operator-Präfixe enthalten: `+`, `-`, `&` und `\|`. Weitere Informationen finden Sie im Abschnitt Operator-Präfixe für Variablenwert. Anmerkung: Das Operator-Präfix wird nicht beibehalten, wenn der Wert auf die Variable angewendet wird.
Type	Optional, Datentyp, den `Wert` darstellt. Gültige Werte sind: Int16 – 16-Bit-Ganzzahl mit Vorzeichen Int32 – 32-Bit-Ganzzahl mit Vorzeichen Real – Gleitkommazahl oder doppelter numerischer Wert String – Einzelzeichen oder mehrere Zeichen Wenn ein Operator-Präfix als Teil des Variablenwerts verwendet wird, muss der entsprechende Datentyp angegeben werden. Wenn die entsprechende Datentyp nicht verwendet wird, wird der Vorgang wird als Zeichenfolge-Operation behandelt.
Flags	Optional, Flags für Erstellen und Ändern. Mehrere Flags können angegeben werden; verwenden Sie einen senkrechten Strich (Pipe-Symbol), um die Flags voneinander zu trennen. Die folgenden Flags werden unterstützt: Create – Die Variable wird erstellt, wenn sie noch nicht vorhanden ist. (Vorgabe) Open – Der Wert der Variable wird jedes Mal geändert, wenn das Plugin geladen wird, und nur dann, wenn die Variable vorhanden ist. OpenOnce – Der Wert der Variable wird beim allerersten Laden des Plugins geändert, und nur dann, wenn die Variable vorhanden ist. Wenn das Plugin deinstalliert und erneut installiert wird, bewirkt dies, dass der Wert der Variablen erneut geändert wird. Anmerkung: Das Flag Open oder OpenOnce muss verwendet werden, um den Wert einer Variablen zu ändern.

Im folgenden Beispiel werden zwei benannte Umgebungsvariablen namens MYNUMVAR und MYSTRVAR erstellt:

<EnvironmentVariables>
    <EnvironmentVariable
        Name="MYNUMVAR"
        Value="123"
    />

    <EnvironmentVariable
        Name="MYSTRVAR"
        Value="Example"
    />
</EnvironmentVariables>

Operator-Präfixe für Variablenwerte

Operator-Präfixe werden verwendet, um den aktuellen Wert einer Variablen zu ändern, wenn das Plugin geladen wird. Sie können eines der in der folgenden Tabelle aufgeführten Operator-Präfixe dem Wertattribut eines RegistryEntry-, SystemVariable- oder EnvironmentVariable-Element hinzufügen.

Präfix	Beschreibung
+ (Pluszeichen)	Addiert einen Wert zu einem vorhandenen Variablenwert oder hängt einen Wert an. Int16, Int32, Real: Addiert den Wert zu einem vorhandenen Variablenwert. String: Hängt den Wert an einen vorhandenen Variablenwert an.
- (Bindestrich)	Subtrahiert oder entfernt einen Wert von einem vorhandenen Variablenwert. Int16, Int32, Real: Subtrahiert den Wert von einem vorhandenen Variablenwert. String: Entfernt den Wert aus einem vorhandenen Variablenwert.
& (Ampersand-Zeichen)	Bitwise UND-Operation mit den vorhandenen Wert der Variablen; nur numerische Werte werden unterstützt.
\| (Senkrechter Strich)	Bitwise ODER-Operation mit den vorhandenen Wert der Variablen; nur numerische Werte werden unterstützt.

Anmerkung: Wenn Sie der Wert einer Systemvariablen mit einem der Operator-Präfixe beginnen soll, fügen Sie einen umgekehrten Schrägstrich vor dem Operator ein. Beispiel: Wenn der Wert der Variablen +radius sein soll, geben Sie den Wert als \+radius ein.

Das Folgende aktiviert immer die Objektfangmodi END, MID, CEN, NOD, QUA und INT und lässt alle anderen Objektfang-Einstellungen auf dem vorhandenen Wert:

<SystemVariable
    Name="OSMODE"
    Value="|63"
    Flags="Open"
/>