Följande steg skapar ett registreringspaket för ett befintligt, icke skrivbordsanpassat program som heter BraTextredigerare.
I exemplet görs följande antaganden om programmet BraTextredigerare:
Det har installerats i katalogen /usr/BTE.
Användarens sessionsspråk är standardspråket, C.
Kommandoraden som startar BraTextredigerare är:
BTEd {filnamn]
där filnamn är namnet på datafilen som ska öppnas i det nya fönstret. BraTextredigerare skapar ett eget fönster, d v s det körs inte i ett terminalemuleringsfönster.
BraTextredigerare skapar och använder två typer av datafiler:
Dokumentationsfiler. Namnkonventionen *.bte används. BraTextredigerare tillhandahåller en kommandorad för utskrift av .bte-datafiler. Syntax för det här kommandot är:
BTEPrint [-d mål] [-s] filnamn
där:
-d mål - anger målskrivaren.
-s - anger tyst utskrift. Programmets dialogruta för utskrift visas inte.
filnamn - anger den fil som ska skrivas ut.
Mallfiler. Namnkonventionen *.tpl används. Mallfiler kan inte skrivas ut.
De befintliga standardfilerna som inte är desktopprogram för BraTextredigerare innehåller resurser för gränssnittsteckensnitt samt förgrunds- och bakgrundsfärger.
En hjälpvolym för BraTextredigerare skapades med skrivbordets Help Developer's Kit. När hjälpvolymen skapades användes följande källfiler:
.../BTEHelp.htg .../graphics/BTE1.xwd .../graphics/BTE2.xwd
och skapade filen .../BTEHelp.sdl.
Följande stegvisa procedur registrerar BraTextredigerare.
Ändra teckensnitt- och färgresurser.
I BraTextredigerares app-defaults-fil tar du bort resurser som anger:
Teckensnitt för text
Färger för förgrund och bakgrund
Skapa programroten.
Skapa katalogen:
/desktop_approots/BTE
Om du integrerar ett befintligt program bör du skapa programrotskatalogen någon annanstans än på installationsplatsen för programmet. Annars kan konfigurationsfilerna som du skapar tas bort när du uppdaterar programmet.
Skapa registreringspaketets kataloger.
Skapa följande kataloger:
/desktop_approots/BTE/dt/appconfig/types/C /desktop_approots/BTE/dt/appconfig/help/C /desktop_approots/BTE/dt/appconfig/icons/C /desktop_approots/BTE/dt/appconfig/appmanager/C/BraTextredigerare
Skapa åtgärderna och datatyperna för programmet.
Skapa konfigurationsfilen för åtgärds- och datatypsdefinitionerna:
/desktop_approots/BTE/dt/appconfig/types/C/BTE.dt
Skapa åtgärdsdefinitionen för att köra BraTextredigerare:
ACTION BTEditor { WINDOW_TYPE NO_STDIO ICON BTERun DESCRIPTION Dubbelklicka på ikonen eller släpp \ en BTE-datafil på den för att starta \ BraTextredigeraren. EXEC_STRING /usr/BTE/BTEd %Arg_1% }
Skapa datatypen för *.bte-filer:
DATA_ATTRIBUTES BTEDataFile { DESCRIPTION Datafil för BraTextredigeraren. ICON BTEData ACTIONS Open,Print } DATA_CRITERIA BTEDataFileCriteria1 { DATA_ATTRIBUTES_NAME BTEDataFile NAME_PATTERN *.bte MODE f }
Skapa datatypen för *.tpl-filer:
DATA_ATTRIBUTES BTETemplateFile { DESCRIPTION Mallfil för BraTextredigeraren. ICON BTETempl ACTIONS Open } DATA_CRITERIAL BTETemplateFileCriteria1 { DATA_ATTRIBUTES_NAME BTETemplateFile NAME_PATTERN *.tpl MODE f }
Skapa Öppna-åtgärden för *.bte-filer.
ACTION Open { ARG_TYPE BTEDataFile TYPE MAP MAP_ACTION BTEditor }
Skapa SkrivUt-åtgärden för *.bte-filer.
Här följer enkla SkrivUt-åtgärder som skriver ut datafiler. De här åtgärderna kräver ett värde för omgivningsvariabeln LPDEST och ignorerar utskriftsalternativet -s. (Om LPDEST inte anges kan åtgärden misslyckas.)
ACTION Print { ARG_TYPE BTEDataFile TYPE MAP MAP_ACTION BTEPrintData }
ACTION BTEPrintData { WINDOW_TYPE NO_STDIO EXEC_STRING BTEPrint -d $LPDEST %Arg_1% }
Här följer en annan version av åtgärden BTEPrintData och ett medföljande skript. Tillsammans hanterar de situationer där LPDEST inte anges eller tyst utskrift begärs.
ACTION BTEPrintData { WINDOW_TYPE NO_STDIO EXEC_STRING /usr/BTE/bin/BTEenvprint \ %(File)Arg_1% }
Innehållet i kommandofilen /usr/BTE/bin/BTEenvprint är:
# BTEenvprint #!/bin/sh DEST="" SILENT="" if [ $LPDEST ] ; then DEST="-d $LPDEST" fi BTEPrint $DEST SILENT $1
Skapa Öppna-åtgärden för *.tpl-filer.
ACTION Open { ARG_TYPE BTETemplateFile TYPE MAP MAP_ACTION BTEditor }
Skapa SkrivUt-åtgärden för *.tpl-filer.
ACTION Print { ARG_TYPES BTETemplateFile TYPE MAP MAP_ACTION NoPrint }
NoPrint är en inbyggd åtgärd som visar en dialogruta där det står att filen inte går att skriva ut.
Placera hjälpfilerna i registreringspaketet.
Placera hjälpfilerna på följande adresser:
/desktop_approots/BTE/dt/appconfig/help/C/BTEHelp.sdl /desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE1.xwd /desktop_approots/BTE/dt/appconfig/help/C/graphics/BTE2.xwd
Skapa filen
/desktop_approots/BTE/dt/appconfig/types/C/BTEhelp.dt.
Placera följande åtgärdsdefinition i filen:
ACTION BTEHelp { WINDOW_TYPE NO_STDIO EXEC_STRING /usr/dt/bin/dthelpview -helpVolume \ BTEHelp.sdl DESCRIPTION Öppnar hjälpen för BraTextredigerare. }
Skapa ikoner för programmet.
Använd Ikonredigeraren för att skapa ikonerna. Tabell 5-3 visar vilken storlek på rutnät som ska användas.
Tabell 5-3 Rutnät för olika storlekar på ikoner
Namn |
Storlek, Sidformat, Grad |
---|---|
grundnamn.t.pm |
16 gånger 16 |
grundnamn.m.pm |
32 gånger 32 |
grundnamn.l.pm |
48 gånger 48 |
Skapa de här ikonfilerna i katalogen /desktop_approots/BTE/dt/appconfig/icons/C:
Ikoner som representerar den åtgärd som kör programmet: BTERun.t.pm, BTERun.m.pm, BTERun.l.pm
Ikoner som representerar *.bte-filer: BTEData.t.pm, BTEData.m.pm,
Ikoner som representerar *.tpl-filer: BTETempl.t.pm, BTETempl.m.pm
Ikoner som representerar programgruppen (används i steg 7): BTEApp.t.pm, BTEApp.m.pm
Skapa katalogen om du inte redan har gjort det.
/desktop_approots/BTE/dt/appconfig/appmanager/C/BraTextredigerare
Det här steget är valfritt. Det skapar en unik ikon för programgruppen genom att skapa en datatyp och associerade åtgärder för programgruppen. Om du utelämnar det här steget använder programgruppen standardikonen.
Lägg till följande datatyps- och åtgärdsdefinitioner i filen /desktop_approots/BTE/dt/appconfig/types/C/BTE.dt. Datatypen anger vilken ikon som ska användas av programgruppen BraTextredigerare. Åtgärderna ger samma Öppna- och SkrivUt-beteende som hos de inbyggda programgrupperna.
DATA_ATTRIBUTES BestTextEditorAppGroup { ACTIONS OpenInPlace,OpenNewView ICON BTEApp {
DATA_CRITERIA BestTextEditorAppGroupCriterial { DATA_ATTRIBUTES_NAME BestTextEditorAppGroup MODE d PATH_PATTERN */appmanager/*/BraTextredigerare }
ACTION Open { ARG_TYPE BestTextEditorAppGroup TYPE MAP MAP_ACTION OpenAppGroup }
ACTION Print { ARG_TYPE BestTextEditorAppGroup TYPE MAP MAP_ACTION PrintAppGroup }
Skapa en ikon i programgruppen som ska starta programmet. För att göra det skapar du filen:
/desktop_approots/BTE/dt/appconfig/appmanager/C \ /BraTextredigerare/BTEditor
och gör filen körbar.
Skapa åtgärdsfilen i programgruppen som ska öppna hjälpvolymen. För att göra det skapar du filen:
/desktop_approots/BTE/dt/appconfig/appmanager/C \ /BraTextredigerare/BTEHelp
och gör filen körbar.
Placera andra filer i programgruppen, t ex "Readme"-filer, exempeldata och mallfiler.
Registrera programmet.
I ett terminalemuleringsfönster: