:: com :: sun :: star :: util ::

service PathSubstitution
Description
A service to support the substitution and resubstitution of path variables.

A path variable must be specified with the following synatx: "$("<variable-name>")". Path variables are not case sensitive and are always provided as a UCB-complient URL's (for example: "file:///c:/temp" or "file:///usr/install"). This is mandatory to support an optional remote file system.
A user defined list of path variables is supported. This list is stored in the Office configuration file (org/openoffice/Office/Substitution.xml). Please have a look at the schema definition file which configuration structure this file uses.
There is also a set of variables that have pre-defined values:

$(inst)
Installation path of the Office.
$(prog)
Program path of the Office.
$(user)
The user installation directory.
$(work)
The work directory of the user. Under Windows this would be the "MyDocuments" subdirectory. Under Unix this would be the home-directory
$(home)
The home directory of the user. Under Unix this would be the home- directory. Under Windows this would be the "Documents and Settings\ " subdirectory.
$(temp)
The current temporary directory.
$(path)
The value of PATH environment variable.
$(lang)
The country code used by the Office, like 01=english, 49=german.
$(langid)
The language code used by the Office, like 0x0009=english, 0x0409=english us.
$(vlang)
The language used by the Office as a string. Like "german" for a german Office.
Since
OpenOffice 1.1.2

Exported Interfaces
XStringSubstitution
Description
Interface to exchange path variables with defined paths and to resubstitute paths with path variables.

To resubstitute path variables the caller must provide pathes as UCB-compliant URL's.


 
Top of Page