Ö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 ... />
  </ComponentEntry>

  <ComponentEntry ... />

  <Commands ...>
    <Command ... />
  </Commands>
</Components>

ComponentEntry elem – az AutoCAD 2013-alapú és újabb termékek támogatják

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. .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 modulokra é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 ObjectARX és .NET modulokra é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.

RegistryEntries elem – az AutoCAD 2015-alapú és újabb termékek támogatják

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
Név	A létrehozandó vagy módosítandó beállításjegyzékbeli bejegyzés neve.
Érték	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.
Típus	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.
Jelzők	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 – az AutoCAD 2015-alapú és újabb termékek támogatják

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
Név	A létrehozandó vagy módosítandó rendszerváltozó neve.
Érték	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
Tulajdonos	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.
Jelzők	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 – az AutoCAD 2015-alapú és újabb termékek támogatják

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
Név	A létrehozandó vagy módosítandó környezeti változó neve.
Érték	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.
Típus	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.
Jelzők	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"
/>

Commands elem – az AutoCAD 2013-alapú és újabb termékek támogatják

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 – az AutoCAD 2013-alapú és újabb termékek támogatják

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
Teljes rajz	Globális parancsnév.
Helyi	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.