Search Results for

    Show / Hide Table of Contents

    The File Context

    Translatable text can occur in one or more contexts. Examples of contexts are file names, URLs, domains, resource types, layout properties (e.g. heading, title, table cell, etc.), and potentially many more. Obviously, contexts can contain other contexts, and they can overlap with other contexts.

    Native File Processing API Representation

    During native content processing contexts are created by the filter through ChangeContext. IContextProperties, the input parameter type of ChangeContext, wraps an IContextInfo array. IContextInfo has following properties:

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

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

    Conversion from Native to Bilingual

    Contexts must be identified, created, and maintained by filters. To pass them into the framework the filter must use the ChangeContext method of the IAbstractNativeContentHandler interface. There is no default context. Using contects is not mandatory, but it is recommended to improve translation and match quality, as translators can easily identify a translatable string as e.g. a headline, footnote, etc., which may be important information for the translation process.

    Conversion from Bilingual to Native

    Contexts are not part of the native format and will therefore not show up in translated 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.

    • Improve this Doc

    On this page

    • Native File Processing API Representation
    • Conversion from Native to Bilingual
    • Conversion from Bilingual to Native
    • See Also
    Back to top Generated by DocFX