Összetevők elem – összefoglalás

A Components elem adja meg a beépülő modul egy verzióját alkotó összetevőket.

Egy beépülő modult több Components elem határozhat meg, és minden Components elem egy vagy több összetevőt azonosíthat. A Components elemek platform- és termékinformációit a RuntimeRequirements elem határozza meg.

Ha az összes Components elemmel meghatározott összetevő ugyanarra a platformra vonatkozik, nem szükséges hozzáadni a RuntimeRequirements elemet minden egyes egyedi ComponentEntry elemhez.

A RuntimeRequirements elem mellett a Components elem egy vagy több elemet tartalmazhat a következők közül

• ComponentEntry
• RegistryEntries
• SystemVariables
• EnvironmentVariables

Megjegyzés: Egy Components elemnek csak egy RegistryEntries, SystemVariables és EnvironmentVariables eleme lehet, de tartalmazhat több ComponentEntry elemet.

A következő leírja a Components elem és az általa tartalmazott kapcsolatát.

<Components>
  <RuntimeRequirements ... />

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

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

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

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

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

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

  <ComponentEntry ... />
</Components>

ComponentEntry elem (AutoCAD 2013-alapú és újabb termékek)

A ComponentEntry elem szükséges, és ezzel adhatók meg a Components elemben lévő összetevők részletes információi.

Tetszőleges számú ComponentEntry elem adható meg. Az összetevőtípusok a következő fájlformátumúak lehetnek:

Windows és Mac OS

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

Csak Windows

• Compiled AutoLISP Project/Visual LISP (VLX)
• Extensible Application Markup Language (XAML)
• JavaScript (JS)
• Kezelt vagy vegyes módú .NET összeállítás (DLL)
• Részleges testreszabás (CUI/CUIx)
• Eszközpaletta (ATC)
• VBA-projekt (DVB)

A ComponentEntry elemek Commands elemet tartalmazhatnak, ha a LoadReasons attribútum értéke LoadOnCommandInvocation.

Megjegyzés: A ComponentEntry elemek a felsorolás sorrendjében, alulról felfelé töltődnek be. Ezért minden olyan fájlt a lista aljára kell helyezni, amelytől más összetevők függnek. Ha például egy ObjectARX modul egy ObjectDBX modultól függ, akkor az ObjectARX modulnak az ObjectDBX modul fölött kell lennie a listán.

A ComponentEntry elemekhez a következő attribútumok tartozhatnak:

Attribútum	Leírás
AppName	Nem kötelező az AutoLISP esetén, szükséges az ObjectARX és .NET esetén - Összetevő neve, azonos az ObjectARX API AcadAppInfo osztály Appname attribútumával.
AppDescription	Összetevő leírása, azonos az ObjectARX API AcadAppInfo osztály AppDescription attribútumával.
AppType	Összetevő típusa, felülírja a ModuleName attribútumban megadott kiterjesztésből származó típust. Az összetevőtípus a következők egyike lehet: .Net – Kezelt vagy vegyes .NET összeállítás Arx – ObjectARX Megjegyzés: Egy ARX-fájlt kell betölteni egy csomagból a Mac rendszeren futó AutoCAD programba. Atc – Eszközpaletta Bundle – BUNDLE csomag Cui vagy CuiX – Részleges testreszabás Dbx – ObjectDBX Dependency – Erőforrás DLL (nem fog betöltődni az AutoCAD-alapú termékbe) JavaScript – JavaScript Lisp vagy CompiledLisp – AutoLISP/Visual LISP Mnu – Menü testreszabása VBA – VBA-projekt Xaml – az XAML fájlokat a környezetfüggő szalaglap megvalósításához használja a program
ModuleName	Az összetevő relatív útvonala a csomagon belül azonos az ObjectARX API AcadAppInfo osztály ModuleName attribútumával. Az összetevő típusát a fájl kiterjesztése határozza meg: .atc – Eszközpaletta .arx – ObjectARX .cuix – Részleges testreszabás .dbx – ObjectDBX .dll – Kezelt .NET összeállítás .dvb – VBA-projekt (AutoCAD 2015-alapú és újabb termékek) Megjegyzés: A DVB fájlokhoz elsőként a VBA Enabler alkalmazást szükséges telepíteni. Betöltéskor kattintson a „Makrók engedélyezése” lehetőségre a projekt és a makrók eléréséhez. Fontos: VBA-projektfájlok jelenleg csak akkor tölthetők be, ha a rajzfájl az indításkor meg van nyitva, és a STARTUP rendszerváltozó értéke 0 vagy 1. .js – Javascript (AutoCAD 2015-alapú és újabb termékek) .lsp, .fas vagy .vlx – AutoLISP/Visual LISP .xaml – Extensible Application Markup Language (AutoCAD 2015-alapú és újabb termékek) Megjegyzés: Az XamlType attribútum beállítása „ContextualTabRule” kell, hogy legyen Ha az alkalmazás több nyelvet kezel, akkor egy adott összetevő különböző verzióit is megadhatja, ha a ModuleName attribútumot egy helykóddal kombinálja. A támogatott helykódok teljes listája a következő helyen található: Támogatott helykódok – összefoglalás. Megjegyzés: Az elérési útvonalak nem „\”, hanem „/” karaktereket tartalmaznak, és a gyökér .bundle mappához viszonyítva értendők.
PerDocument	Csak az AutoLISP esetén - Igaz érték esetén az AutoLISP-fájl dokumentumonként egyszer töltődik be. Az alapértelmezett érték az Igaz.
LoadReasons	Több érték is megadható - Meghatározza az összetevő betöltési viselkedésének paramétereit a LoadReasons attribútummal, a LoadOnCommandInvocation paraméter kivételével. Alapértelmezés szerint a LoadOnAutoCADStartup, a LoadOnAppearance és a LoadOnProxy engedélyezve van (Igaz értékre van állítva), ha a LoadReasons nincs megadva. Ha a paramétereket le kell tiltani (Hamis értékre állítani), akkor a paraméterek Hamis értékre állítása mellett a LoadReasons elemet is meg kell adni. A LoadOnCommandInvocation alapértelmezés szerint le van tiltva, és az engedélyezése letiltja a LoadOnAutoCADStartup és a LoadOnAppearance elemeket, hacsak nem engedélyezi őket külön. Ha egy vagy több Command elem a Components elem részeként van definiálva, a LoadOnCommandInvocation implicit módon engedélyezett. Az AcadAppInfo LoadReasons elem további részleteit lásd az ObjectARX Reference Guide kézikönyvben. Érvényes paraméterértékek: Igaz – A paraméter engedélyezve van Hamis – a paraméter le van tiltva A következő paraméterek érhetők el: LoadOnCommandInvocation. Betöltés csak egyéni parancs hívása esetén. Ezen paraméter használata esetén meg kell adni egy „Commands” elemet. Ha a LoadOnCommandInvocation engedélyezve van, a program feltételezi, hogy a LoadOnAutoCADStartup és a LoadOnAppearance le van tiltva, hacsak nincsenek külön engedélyezve. Csak AutoLISP-, ObjectARX- és .NET-fájlokra érvényes. Megjegyzés: A jó indítási teljesítmény érdekében nagyon fontos ezt az opciót használni, ha az összetevők parancsokat határoznak meg. LoadOnAutoCADStartup. Betöltés az AutoCAD-alapú termék indulásakor. Ha meg van adva, ez a paraméter az összes többivel szemben elsőbbséget élvez. A LoadOnAutoCADStartup használata akkor javasolt, ha a többi paraméter közül egyik sem megfelelő, azonban amikor csak lehetséges, érdemes letiltani (Hamis értékre állítani). Ha a LoadOnAutoCADStartup paraméter el van hagyva, akkor az engedélyezett (Igaz értékre állított) értékre áll vissza, kivéve ha a LoadOnCommandInvocation engedélyezve van, amely esetben a LoadOnAutoCADStartup alapértelmezett értéke Hamis. Csak VBA Project-, ObjectARX- és .NET-fájlokra érvényes. LoadOnProxy. Betöltés egyéni elem proxyjának érzékelésekor. Alapértelmezés szerint ez a paraméter engedélyezve van, kivéve ha külön le van tiltva (Hamis értékre van állítva). Ha engedélyezve van (Igaz értékre van állítva), a LoadOnAutoCADStartup paramétert le kell tiltani. Csak ObjectDBX fájlokra érvényes. LoadOnAppearance. Betöltés, amikor a termék érzékeli az alkalmazáscsomagot valamelyik ApplicationPlugins mappában, így támogatja az azonnali betöltést a telepítés után az AutoCAD-alapú termék újraindítása nélkül. A paraméter ugyanúgy viselkedik, mint a LoadOnAutoCADStartup, kivéve hogy a betöltési környezet fontos abban az esetben, ha egy alkalmazást a termék futtatása közben telepítenek, például ha az Autodesk App Store weboldalán keresztül telepítik.
XamlType	Az XAML típus esetében jelenleg az egyetlen támogatott érték a „ContextualTabRule”, és kötelező megadni, amikor a program egy XAML-fájlt rendel a ModuleName attribútumhoz. Az XAML-fájlt használó alkalmazásfájlt azután a ComponentEntry elem után kell megjeleníteni, amely az XAML-fájlt tartalmazza.

Commands elem (AutoCAD 2013-alapú és újabb termékek)

A Commands elem nem kötelező, kivéve ha a LoadOnCommandInvocation paraméter engedélyezve van a LoadReasons attribútumon. Azt adja meg, hogy mely parancsok használhatók a LoadOnCommandInvocation paraméterrel.

Tetszőleges számú Command elem adható meg.

A Commands elemekhez a következő attribútumok tartozhatnak:

Attribútum	Leírás
GroupName	A kapcsolódó parancsok rendezéséhez használt név.

Command elem (AutoCAD 2013-alapú és újabb termékek)

Az egyes parancsok globális és helyi nevét adja meg.

A Command elemekhez a következő attribútumok tartozhatnak:

Attribútum	Leírás
Global	Globális parancsnév.
Local	Helyi parancsnév. A parancsok több nyelvhez meghatározhatók a Helyi attribútum és egy helykód kombinálásával. A támogatott helykódok teljes listája a következő helyen található: Támogatott helykódok – összefoglalás.
HelpTopic	Az F1 billentyű lenyomásakor megnyíló súgótémakör, ha a parancs aktív. Megjegyzés: A súgótémakör megjelenítéséhez a súgófájlt hozzá kell rendelni a beépülő modulhoz. A súgófájl beépülő modulhoz hozzárendelt helye az ApplicationPackage elem alatti HelpFile attribútummal van megadva.
StartupCommand	Végrehajtja a parancsot indításnál, ha az érték Igaz.

A következő példában két, az ADSKCMDS nevű csoportban definiált parancsot hozzáadása látható:

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

AssemblyMappings elem (AutoCAD 2013-alapú és újabb termékek)

Az AssemblyMappings elem használata nem kötelező, és egy vagy több AssemblyMapping vagy AssemblyMappingFolder elemet tartalmazhat. Az AssemblyMapping és az AssemblyMappingFolder elemek olyan összeállításfájlok és mappaútvonalak belső listákhoz való hozzáadására szolgálnak, amelyeket az AutoCAD a termék telepítési mappájában nem található összeállítások feloldására használ.

AssemblyMapping elem (AutoCAD 2013-alapú és újabb termékek)

Attribútum	Leírás
Name	Annak a ComponentEntry elemnek a neve, amelyhez az összeállítás társítva van, és amellyel együtt a programnak be kell töltenie.
Path	Az összeállítás relatív útvonala a csomagon belüli.

AssemblyMappingFolder elem (AutoCAD 2022-alapú és újabb termékek)

Attribútum	Leírás
Path	Az összeállítások relatív útvonala a csomagon belüli.

A következő példában két olyan mappa hozzáadása látható, amelyek részegység által használt összeállításokat tartalmaznak:

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

RegistryEntries elem (AutoCAD 2015-alapú és újabb termékek)

A RegistryEntries elem használata nem kötelező, és tartalmazhat egy vagy több RegistryEntry elemet. A RegistryEntry elem tartalmazza a beállításjegyzékbeli bejegyzés definícióját, amelyet a beépülő modul hoz létre vagy módosít. A beállításjegyzékbeli bejegyzéseket a Windows beállításjegyzék vagy Mac OS rendszeren egy tulajdonságlista (PLIST) fájl tartalmazza.

Megjegyzés: Windows rendszeren a beállításjegyzékbeli bejegyzések a HKEY_CURRENT_USER\Software\Autodesk\AutoCAD\<kiadás>\ACAD-<termék>:<nyelv> útvonalon jönnek létre. Más helyen nem hozhatók létre a beállításjegyzékbeli bejegyzések. Mac OS rendszeren a PLIST-fájl ugyanezt a helyet használja.

RegistryEntry elem

Attribútum	Leírás
Name	A létrehozandó vagy módosítandó beállításjegyzékbeli bejegyzés neve.
Value	A beállításjegyzékbeli bejegyzéshez hozzárendelendő érték. Az érték egyet tartalmazhat a következő lehetséges operátor előtagok közül: +, -, & és |. Lásd a „Változó értékű operátor előtagok” szakaszt további információért. Megjegyzés: Az operátor előtag nem marad meg, amikor az értéket a program a beállításjegyzékbeli bejegyzésre alkalmazza.
Type	A beállításjegyzékbeli bejegyzéshez hozzárendelendő adattípus. A létező beállításjegyzékbeli bejegyzések módosításakor nem kötelező. A lehetséges értékek: REG_SZ – Karakterlánc, nullával záruló REG_EXPAND_SZ – Karakterlánc, amely tartalmaz egy kibontatlan környezeti változót, például a %APPDATA% változót, nullával záruló REG_DWORD – 32 bites, előjel nélküli egész szám REG_DWORD – 64 bites, előjeles egész szám Ha a beállításjegyzékbeli bejegyzés értékéhez operátor előtagot is használ, akkor adja meg a megfelelő adattípust. Ha nem a megfelelő adattípust használja, akkor a műveletet karakterlánc műveletként hajtja végre a program.
Flags	Nem kötelező jelzők létrehozása és módosítása. Több jelző is megadható, használjon pipa jelet a jelzők elválasztásához. A következő jelzők támogatottak: Create – A program létrehozza a beállításjegyzékbeli bejegyzést, ha az még nem létezik. (Alapértelmezett viselkedés) Open – Meglévő beállításjegyzékbeli bejegyzés esetén a beépített modul minden betöltődésekor módosul annak értéke. OpenOnce – Meglévő beállításjegyzékbeli bejegyzés esetén a beépített modul első betöltődésekor módosul annak értéke. A beépített modul eltávolításával és újratelepítésével a beállításjegyzékbeli bejegyzés értéke ismét módosul. Megjegyzés: Az Open és az OpenOnce jelzőt kell használni a beállításjegyzékbeli bejegyzés értékének módosításához.

A következő példa létrehozza a MYREGKEY rendszerleíró kulcsot, és hozzáadja a STRING és NUMBER értékeket:

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

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

SystemVariables elem (AutoCAD 2015-alapú és újabb termékek)

A SystemVariables elem használata nem kötelező, és tartalmazhat egy vagy több SystemVariables elemet. A SystemVariable elem tartalmazza a beépülő modul által létrehozandó vagy módosítandó rendszerváltozó definícióját.

SystemVariable elem

Attribútum	Leírás
Name	A létrehozandó vagy módosítandó rendszerváltozó neve.
Value	A változóhoz hozzárendelendő érték. Az érték egyet tartalmazhat a következő lehetséges operátor előtagok közül: +, -, & és |. Lásd a „Változó értékű operátor előtagok” szakaszt további információért. Megjegyzés: Az operátor előtag nem marad meg, amikor az értéket a program a változóra alkalmazza.
PrimaryType	A változóhoz hozzárendelendő adattípus. Egy létező rendszerváltozó módosításakor nem kötelező. A lehetséges értékek: Int16 – 16 bites, előjeles egész szám Int32 – 32 bites egész számok Real – Lebegő vagy dupla numerikus érték String – Egyszeres vagy többszörös karakterérték Ha a változó értékéhez operátor előtagot is használ, akkor adja meg a megfelelő adattípust. Ha nem a megfelelő adattípust használja, akkor a műveletet karakterlánc műveletként hajtja végre a program.
StorageType	A változó értékének tárhelye, ha a program megőrzi azt. Egy létező rendszerváltozó módosításakor nem kötelező. A lehetséges értékek: Database – A változó létrehozási rajzfájljában őrzi meg a program Profile – Az aktuális AutoCAD profilban őrzi meg a program Session – Az értékek nem maradnak meg a munkaszakaszok között, illetve a létrehozott rajzban User – A FixedProfile AutoCAD profilban őrzi meg a program
Owner	Nem kötelező AcRX szolgáltatás név. A rendszerváltozó írásvédetté tételére használható, amelyet csak egy, a szolgáltatás nevét az acrxRegisterService() használatával regisztráló alkalmazás módosíthat.
Flags	Nem kötelező jelzők létrehozása és módosítása. Több jelző is megadható, használjon pipa jelet a jelzők elválasztásához. A következő jelzők támogatottak: Create – A program létrehozza a változót, ha az még nem létezik. (Alapértelmezett viselkedés) Open – Meglévő változó esetén a beépített modul minden betöltődésekor módosul annak értéke. OpenOnce – Meglévő változó esetén a beépített modul első betöltődésekor módosul annak értéke. A beépített modul eltávolításával és újratelepítésével a változó értéke ismét módosul. SpacesAllowed – A szóköz használata lehetséges a parancspromptban. Ha nincs megadva, a szóköz lenyomása az Enter billentyű lenyomásával azonos. Megjegyzés: Csak a Create jelzővel használható, és csak akkor, ha a PrimaryType attribútum beállítása String. DotIsEmpty – Lehetséges a változó értékének törlése egy „.” (pont) beírásával a változó értékeként. Megjegyzés: Csak a Create jelzővel használható, és csak akkor, ha a PrimaryType attribútum beállítása String. NoUndo – A változó módosításait a program nem rögzíti, és a módosítások nem vonhatók vissza a V vagy a VISSZA paranccsal. Megjegyzés: Csak a Create jelzővel használható. Chatty – Reaktor értesítést küld a program akkor is, ha a változó értékét az aktuális értékre állítja be. Megjegyzés: Csak a Create jelzővel használható. Megjegyzés: Az Open és az OpenOnce jelzőt kell használni a változó értékének módosításához.

A következő példa a MYVARIABLE nevű változót hozza létre:

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

A következő példa megváltoztatja a CURSORSIZE rendszerváltozó értékét 100-ra a beépített modul első betöltésekor:

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

EnvironmentVariables elem (AutoCAD 2015-alapú és újabb termékek)

Az EnvironmentVariables elem használata nem kötelező, és tartalmazhat egy vagy több EnvironmentVariable elemet. Az EnvironmentVariable elem tartalmazza a beépülő modul által létrehozandó vagy módosítandó környezeti változó definícióját. A környezeti változókat a Windows beállításjegyzék vagy Mac OS rendszeren egy tulajdonságlista (PLIST) fájl tartalmazza.

Megjegyzés: A környezeti változók értékét mindig karakterláncként menti a program, és a nevében megkülönböztet a kis- és nagybetűket.

EnvironmentVariable elem

Attribútum	Leírás
Name	A létrehozandó vagy módosítandó környezeti változó neve.
Value	A változóhoz hozzárendelendő érték. Az érték egyet tartalmazhat a következő lehetséges operátor előtagok közül: +, -, & és |. Lásd a „Változó értékű operátor előtagok” szakaszt további információért. Megjegyzés: Az operátor előtag nem marad meg, amikor az értéket a program a változóra alkalmazza.
Type	Nem kötelező adattípus, amely az Érték jelöl. A lehetséges értékek: Int16 – 16 bites, előjeles egész szám Int32 – 32 bites, előjeles egész szám Real – Lebegő vagy dupla numerikus érték String – Egyszeres vagy többszörös karakterérték Ha a változó értékéhez operátor előtagot is használ, akkor adja meg a megfelelő adattípust. Ha nem a megfelelő adattípust használja, akkor a műveletet karakterlánc műveletként hajtja végre a program.
Flags	Nem kötelező jelzők létrehozása és módosítása. Több jelző is megadható, használjon pipa jelet a jelzők elválasztásához. A következő jelzők támogatottak: Create – A program létrehozza a változót, ha az még nem létezik. (Alapértelmezett viselkedés) Open – Meglévő változó esetén a beépített modul minden betöltődésekor módosul annak értéke. OpenOnce – Meglévő változó esetén a beépített modul első betöltődésekor módosul annak értéke. A beépített modul eltávolításával és újratelepítésével a változó értéke ismét módosul. Megjegyzés: Az Open és az OpenOnce jelzőt kell használni a változó értékének módosításához.

Az alábbiakban a MYNUMVAR és a MYSTRVAR nevű környezeti változók létrehozására talál példát:

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

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

A változók értékeinek operátor előtagjai

Az operátor előtagok a változók aktuális értékét módosítják, ha a beépülő modul be van töltve. A RegistryEntry, SystemVariable vagy EnvironmentVariable elem Érték attribútumához a következő táblázatban megadott operátor előtagok egyikét adhatja hozzá.

Előtag	Leírás
+ (plusz jel)	Hozzáadja vagy hozzáfűzi az értéket egy meglévő változó értékéhez. Int16, Int32, Real: Hozzáadja az Értéket egy meglévő változó értékéhez. String: Hozzáfűzi az Értéket egy meglévő változó értékéhez.
- (kötőjel)	Kivonja vagy eltávolítja az értéket egy meglévő változó értékéből. Int16, Int32, Real: Kivonja az Értéket egy meglévő változó értékéből. String: Eltávolítja az Értéket egy meglévő változó értékéből.
& (és)	Bitenként elvégzett ÉS művelet a változó meglévő értékével, csak numerikus értékek esetén támogatott.
| (pipa jel)	Bitenként elvégzett VAGY művelet a változó meglévő értékével, csak numerikus értékek esetén támogatott.

Megjegyzés: Ha egy változó értékéhez operátor előtagot szeretne adni, írjon egy fordított perjelet az operátor előtag elé. Például, ha a változó értéke +sugár kell, hogy legyen, használja a \+sugárértéket.

A következő mindig engedélyezi az END, MID, CEN, NOD, QU és INT futó tárgyrasztereket, és változatlanul hagyja az egyéb tárgyraszter-beállításokat:

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