Solaris Common Desktop Environment: Handbok för avancerade användare och systemadministratörer

Skapa en åtgärd manuellt: Allmänna steg

Det här avsnittet beskriver hur du skapar en konfigurationsfil för en åtgärdsdefinition.

Konfigurationsfiler för åtgärder

Konfigurationsfiler som innehåller åtgärdsdefinitioner måste uppfylla följande krav:

Filerna måste använda namngivningskonventionen namn.dt.

Filerna måste finnas i databasens (åtgärder och datatyper) sökväg. Standardsökväg:

Egna åtgärder – Hemkatalog/.dt/types

Åtgärder för hela systemet – /etc/dt/appconfig/types/språk

Inbyggda åtgärder – /usr/dt/appconfig/types/språk. Du bör inte använda den här katalogen.

Mer information om hur du ändrar sökväg för åtgärder och datatyper finns i Ange värde för en sökväg.

Skapa en åtgärd manuellt

Öppna en befintlig databasfil eller skapa en ny.

Se föregående avsnitt, Konfigurationsfiler för åtgärder.

Skapa en åtgärdsdefinition med syntaxen:
```
	ACTION åtgärdsnamn
 	{
 		TYPE		åtgärdstyp
 		åtgärdsfält
 		…
 	}
```
där:

åtgärdsnamn – anger namnet som används för att köra åtgärden

åtgärdstyp – COMMAND (standard), MAP eller TT_MSG.

åtgärdsfält – ett av de nödvändiga eller valfria fälten för den här typen av åtgärd. Alla fält består av ett nyckelord och ett värde.

Många av åtgärdsfälten beskrivs i det här kapitlet. Mer information finns i direkthjälpen (man page) för dtactionfile(4).

Spara filen.

Om du vill att åtgärdsikonen ska ha en unik bild skapar du en ikon till åtgärden. Standardadressen för ikoner är:
- Egna ikoner: Hemkatalog/.dt/icons
- Systemtäckande ikoner: /etc/dt/appconfig/icons/språk. Standardalternativet för språk är C.
  
  Mer information finns i Ange åtgärdens ikonbild.

Dubbelklicka på Ladda om åtgärder i programgruppen Skrivbordsverktyg.

Skapa åtgärdsfilen för åtgärden. Åtgärdsfilen skapar en ikon i filhanteraren eller programhanteraren som representerar åtgärden. (Om åtgärden är skriven för att starta ett program kallas ikonen för programikon.)

Om du vill skapa en åtgärdsfil skapar du en körbar fil med samma namn som ett åtgärdsnamn. Du kan placera den här filen i en valfri katalog, som du har skrivbehörighet till. Du kan skapa så många åtgärdsfiler du vill.

Exempel på hur du skapar en COMMAND-åtgärd

I följande steg skapas en egen åtgärd som startar ett faxprogram i fjärrsystemet ProgServerA. Kommandot som startar faxprogrammet är:

/usr/fax/bin/faxcompose [filnamn]

Skapa filen Hemkatalog/.dt/types/Fax.dt.

Placera följande åtgärdsdefinition i filen:
```
	ACTION FaxComposer
 	{
 		TYPE					COMMAND
 		ICON					fax
 		WINDOW_TYPE			NO_STDIO
 		EXEC_STRING			/usr/fax/bin/faxcompose -c %Arg_1%
 		EXEC_HOST     	 	AppServerA
 		DESCRIPTION    	Kör faxprogrammet
```
```
	}
```
Fälten WINDOW_TYPE och EXEC_STRING beskriver åtgärdens uppförande.

WINDOW_TYPE – nyckelordet NO_STDIO anger att åtgärden inte behöver köras i ett terminalemulatorfönster.

See Ange fönsterstöd för åtgärden.

EXEC_STRING – syntaxen %Arg_1% accepterar en släppt fil. Om någon dubbelklickar på åtgärdsikonen, öppnar åtgärden ett tomt faxassistentfönster.

Se Skapa en exekveringssträng för COMMAND-åtgärder.

Spara filen.

Skapa följande ikonbildsfiler i Hemkatalog/.dt/icons med hjälp av Ikonredigeraren:
- fax.m.pm, 32 gånger 32 bildpunkter
- fax.t.pm, 16 gånger 16 bildpunkter

Dubbelklicka på Ladda om åtgärder i programgruppen Skrivbordsverktyg.

Skapa en körbar fil med namnet FaxComposer i en katalog som du har skrivbehörighet till (t ex hemkatalogen).

Exempel på hur du skapar en MAP-åtgärd

Anta att de flesta filer du faxar skapas med Textredigeraren och är av datatypen TEXTFILE (filer med namnet *.txt).

Stegen nedan lägger till menyalternativet ''Fax'' på datatypens Markera-meny.

Öppna filen Hemkatalog/.dt/types/Fax.dt, som skapades i föregående exempel.

Lägg till den här tilldelningsdefinitionen i filen:

	ACTION Fax
 	{
 		ARG_TYPE			TEXTFILE
 		TYPE				MAP
 		MAP_ACTION		FaxComposer
 	}

Spara filen.

Kopiera en dataattributsdefinition för TEXTFILE från /usr/dt/appconfig/types/språk/dtpad.dt till den nya filen Hemkatalog/.dt/types/textfile.dt. Lägg till åtgärden Fax i fältet ACTIONS .
```
	DATA_ATTRIBUTES TEXTFILE
 	{
 		ACTIONS			Open,Print,Fax
 		ICON				Dtpenpd
 		…
 	}
```

Spara filen.

Öppna programhanteraren och dubbelklicka på Ladda om funktioner i programgruppen Skrivbordsverktyg.

Starta om databasen för åtgärder och datatyper

För att nya och redigerade åtgärdsdefinitioner ska träda i kraft måste skrivbordet läsa om databasen.

Öppna programgruppen Skrivbordsverktyg och dubbelklicka på Ladda om åtgärder.

Eller kör kommandot:

	dtaction ReloadActions

ReloadActions är namnet på den åtgärd vars ikon heter ''Ladda om åtgärder''.

Åtgärdsdatabasen läses också om när användaren:

Loggar in

Startar om arbetsytehanteraren

Sparar en åtgärd i fönstret Skapa åtgärd genom att välja Spara på Fil-menyn.

Skapa åtgärdsfil (ikon) för åtgärd

En åtgärdsfil är en fil som skapas för att visuellt representera åtgärden i filhanteraren eller programhanteraren.

Figur 12–1 Åtgärdsfiler (åtgärdsikoner) i programhanteraren

Eftersom en åtgärdsfils ikon representerar en åtgärd, kallas den ibland åtgärdsikon. Om den underliggande åtgärden startar ett program, kallas åtgärdsfilsikonen för programikon.

Om du dubbelklickar på åtgärdsikonen körs åtgärden. Åtgärdsikonen kan också vara ett släppområde.

Skapa en åtgärdsfil (åtgärdsikon)

Skapa en körbar fil med samma namn som åtgärdsnamnet. Innehållet i filen har ingen betydelse.

Om åtgärdsdefinitionen är:

ACTION  MyFavoriteApp
 {
 	EXEC_STRING				Mfa -file %Arg_1%
 	DESCRIPTION				Kör MyFavoriteApp
 	ICON						Mfapp
 }

blir åtgärdsfilen en körbar fil med namnet MyFavoriteApp. I filhanteraren och programhanteraren använder filen MyFavoriteApp ikonbilden Mfapp.storlek.typ. Om du dubbelklickar på ikonen MyFavoriteApp körs åtgärdens exekveringssträng, och innehållet i fältet DESCRIPTION utgör ikonens objekthjälp (”Kör MyFavoriteApp”).

Åtgärdsnamn

Om åtgärdsdefinitionen innehåller fältet LABEL , får åtgärdsfilen innehållet i detta fält som namn i filhanteraren och programhanteraren i stället för filnamnet (åtgärdsnamn). Om åtgärdsdefinitionen t ex innehåller:

ACTION  MyFavoriteApp
 {
 	LABEL      Mitt favoritprogram
 	…
 }

kommer åtgärdsikonen att heta "Mitt favoritprogram".

Ange åtgärdens ikonbild

Använd fältet ICON för att ange vilken ikonbild som ska användas i filhanteraren och programhanteraren för den åtgärdsikon som skapas för åtgärden.

Om du inte anger någon ikon används bildfilerna för standardåtgärdsikoner:

Figur 12–2 Standardbild för åtgärdsikon

Standardåtgärdsikonen ändras med resursen:

*actionIcon:    ikonfilnamn

där ikonfilnamn kan vara ett grundnamn eller en absolut sökväg.

Värdet på fältet ICON kan vara:

Ett basfilnamn.

Grundfilnamnet är namnet på filen som innehåller ikonen minus filnamnssuffixen för storlek (m och t) och bildtyp (bm och pm). Använd till exempel GameIcon om filnamnet är GameIcon.m.pm eller GameIcon.t.pm.

Om du använder basfilnamnet måste ikonfilerna placeras i en katalog i ikonsökvägen:
- Egna ikoner: Hemkatalog/.dt/icons
- Systemtäckande ikoner: /etc/dt/appconfig/icons/språk

En absolut sökväg till ikonfilen, inklusive fullständigt filnamn.

Du ska bara använda den absoluta sökvägen om ikonfilen inte finns i ikonsökvägen. Om till exempel ikonfilen Spelikon.m.pm finns i katalogen /doc/projects, som inte finns i ikonsökvägen, blir värdet i fältet ICON /doc/projects/Spelikon.m.pm.

I Tabell 12–1 finns en lista över de ikonstorlekar du ska skapa och motsvarande filnamn.

Tabell 12–1 Ikonnamn och storlek på åtgärdsikoner


Storleken i bildpunkter	Bitmappsnamn	Pixmappsnamn
48 gånger 48	`namn.l.bm`	`namn.l.pm`
32 gånger 32	`namn.m.bm`.	`namn.m.pm`
16 gånger 16	`namn.t.bm`	`namn.t.pm`

Ändra en befintlig åtgärdsdefinition

Du kan ändra alla åtgärder som finns tillgängliga i systemet, inklusive inbyggda åtgärder.

Obs!

Var försiktig när du ändrar databasen för inbyggda åtgärder. De inbyggda åtgärderna är utformade speciellt för att fungera med skrivbordsprogrammen.

Sök reda på definitionen till åtgärd du vill ändra.

Standardsökvägen för åtgärdsdefinitioner är:
- Inbyggda åtgärder: /usr/dt/appconfig/types/språk
- Åtgärder för hela systemet: /etc/dt/appconfig/types/språk
- Egna åtgärder: Hemkatalog/.dt/types
  
  Det kan finnas fler sökvägar i systemet. Om du vill visa en lista med de sökvägar som systemet använder för åtgärder, skriver du kommandot:
```
	dtsearchpath -v
```
  Systemet använder katalogerna som visas i listan under DTDATABASESEARCHPATH.

Om det behövs kopierar du texten till åtgärdsdefinitionen till en ny eller befintlig fil i någon av dessa kataloger:
- Åtgärder för hela systemet: /etc/dt/appconfig/types/språk
- Egna åtgärder: Hemkatalog/.dt/types
  
  Du måste kopiera inbyggda åtgärder eftersom du inte bör redigera filer i katalogen /usr/dt/appconfig/types/språk.

Redigera åtgärdsdefinitionen.

När du är färdig med redigeringen sparar du filen.

Dubbelklicka på Ladda om åtgärder i programgruppen Skrivbordsverktyg.

Prioritet i åtgärdsdefinitioner

När användarna anropar en åtgärd söker systemet i databasen efter ett matchande åtgärdsnamn. När det finns fler än en åtgärd med samma namn används prioritetsregler för att bestämma vilken åtgärd som ska användas.

Om inga andra prioritetsregler gäller, baseras prioriteten på definitionens sökväg. Följande lista är rangordnad från högsta till lägsta prioritet:
- Egna åtgärder: Hemkatalog/.dt/types
- Lokala åtgärder för hela systemet: /etc/dt/appconfig/types/språk
- Fjärråtgärder för hela systemet (värdnamn:/etc/dt/appconfig/types/språk). De fjärranslutna värddatorer som genomsöks är de som listas i programmets sökväg.
- Inbyggda åtgärder: /usr/dt/appconfig/types/språk

Inom en viss katalog läses filerna *.dt i alfabetisk ordning.

Åtgärder som begränsas av ARG_CLASS, ARG_TYPE, ARG_MODEARG_COUNT prioriteras framför obegränsade åtgärder. (Standardvärdet för dessa fyra fält är *.)

När fler än en begränsning gäller är prioritetsordningen (från hög till låg):
- ARG_CLASS
- ARG_TYPE
- ARG_MODE
- ARG_COUNT
  
  När det finns fler än en begränsad ARG_COUNT är prioritetsordningen (från hög till låg):
- Specifikt heltalsvärde n
- <n
- >n
- *
Ta följande del av en åtgärdsdefinition som exempel:
```
ACTION EditGraphics
 # EditGraphics-1
 {
 	ARG_TYPE				XWD
 	…
 }
 
```
```
ACTION EditGraphics
 # EditGraphics-2
 {
 	ARG_COUNT  				0
 	…
 }
 
```
```
ACTION EditGraphics
 # EditGraphics-3
 {
 	ARG_TYPE  		*
     …
 }
```
När du dubbelklickar på åtgärdsikonen för EditGraphics startar EditGraphics-2 eftersom inga argument har angivits och ARG_COUNT 0 har företräde. När filargument av XWD-typ tillhandahålls, används EditGraphics-1 eftersom det angav XWD som ARG_TYPE. EditGraphics-3 används för alla andra filargument.