long overrideDefaultFontName(string fontDescription)

This method changes the current default font held by the TextAPI object to that given by fontDescription. This argument must contain a valid font description string.  Valid font description strings are obtained by parsing the return values from the method ProgramAPI.getFontList.  On Chinese systems, this list includes Chinese (as well as English) fonts.

The default font is used whenever a new text feature is created, via any of the following methods:

The initial default font is "Times New Roman".  On Chinese systems, 

  1. If the initial default font has not been overridden or it has been overridden by another English font, and
  2. A Chinese label is supplied (via one of the above methods), 

the Chinese font "hsi ming ti" is substituted as the default.  If the default font has been overridden by a Chinese font, both Chinese and English labels will be shown in the new font, with the appearance of English characters being determined by the way they are defined in the Chinese font. (Chinese fonts support Western characters.)

This method returns 0 upon success, and returns an error code if the fontDescription is invalid.