The File Context

Translatable text can appear in one or more contexts. Examples include file names, URLs, domains, resource types, and layout properties such as headings, titles, and table cells. Contexts can contain other contexts, and they can overlap.

Native File Processing API representation

During native content processing, the filter creates contexts through ChangeContext. The IContextProperties parameter wraps an array of IContextInfo objects.

IContextInfo exposes the following properties:

• ContextType
• DefaultFormatting
• Description
• DisplayCode
• DisplayColor
• DisplayName
• Purpose

Every call to ChangeContext closes the currently open contexts and opens the contexts specified in the call.

Conversion from native to bilingual

Filters must identify, create, and maintain contexts. To pass them into the framework, use the ChangeContext method on IAbstractNativeContentHandler. The framework does not provide a default context.

Contexts are optional, but they improve translation and match quality. For example, they help translators identify whether a string is a heading, footnote, or another content type that affects translation.

Conversion from bilingual to native

Contexts are not part of the native file format, so they do not appear in translated output files.

See also

• Adding Context Information

Note

This content may be out-of-date. To check the latest information on this topic, inspect the libraries using the Visual Studio Object Browser.