Xceed Zip for COM/ActiveX on x86/x64 Documentation
Xceed Zip control reference / Xceed Zip control properties / TextEncoding property
In This Topic
    TextEncoding property
    In This Topic

    Description

    The TextEncoding property allows you to specify the default text encoding that will be applied to files that are added to the zip file.

    Data type

    xcdTextEncoding

    Possible values

    Value Meaning
    xteStandard The "OEM" text encoding will be used. It consists of ASCII characters. Non-ASCII characters will be encoded according to code page 437 or whatever your system defines as the OEM code page through the registry key HKLM\SYSTEM\CurrentControlSet\Control\Nls\CodePage\OEMCP.

    This is the default encoding and is supported by all Zip utilities.

    xteUnicode 8-bit Unicode text (UTF-8) will be used. This encoding appears as part of the Zip Specification 6.3.0. It might not be supported by every zip utility. In that case, you might get mangled filenames and file comments if they contain non-ASCII characters.

    As of this writing, WinZip 12 uses this encoding as an option.

    For maximum compatibility, use the xehUTF8Filename and xehUTF8Comment extra headers instead of this value. These headers will contain the same information, but they will be written as extra headers instead of being part of the main headers. As such, they will be safely ignored by zip utilities that don't support them.

    Default value

    xteStandard

    Declaration (DLL API)  

    UINT XzGetTextEncoding( HXCEEDZIP hZip )
    void XzSetTextEncoding( HXCEEDZIP hZip, UINT uValue )

    Remarks

    This property doesn't apply when unzipping files. The library automatically detects the correct text encoding to use based on the headers inside the zip file.

    This property determines which text encoding will be used in the main zip headers. As such, it doesn't affect the xehUnicode, xehUTF8Filename and xehUTF8Comment extra headers.

    Applicable methods

    Zip, Convert

    See Also