File Content Extraction 25.1
Filter SDK C++ Programming Guide

# Enumerations

The following enumerations are defined in the C++ SDK.

Enumeration | Description
--- | ---
`Encoding` | An enumeration of character encodings. SeeCoded Character Sets for more information.
`Category` | File type categories (such as word processor or spreadsheet). These are listed in File Classes.
`Format` | File formats (e.g. Word, Excel, PDF etc.). These are listed in Supported Formats.
`CredentialKeyType` | Credential types, used in the CredentialComponent struct.
`LogicalPDFDirection` | This enumeration is used to specify paragraph ordering when filtering a PDF.
`MetadataValueType` | A list of the possible value types for metadata items.
`MetadataKey` | The standard keys used for metadata field standardization.
`OCROrientation` | The options for detecting rotated text during OCR.
`OCRTextFindingMode` | The algorithms for finding text during OCR.
`OCRDetectAlphabet` | The options for alphabet detection during OCR.
`ShowFormulasAs` | The options for how to output cell values that are calculated from a formula.
`SourceCodeIdentificationLevel` | The options for running source code identification.
`SubFile::Type` | This enumeration lists the possible categories of subfiles.
`SubfileChecksumType` | The type of checksum stored in the container file, for a subfile.
`SummaryInfoType` | This enumeration is a return type from the `SummaryInfoItem` class.

## CredentialKeyType

The following table lists the values of the `CredentialKeyType` enumeration.

Value | Description
--- | ---
`UserName` | The credential component key is a user name.
`UserIdFile` | The credential component key is a path to a file that contains user IDs.
`Password` | The credential component key is a password.

## LogicalPDFDirection

The following table lists the values of the `LogicalPDFDirection` enumeration.

Value | Description
--- | ---
`raw` | Unstructured paragraph flow. This is the default behavior.
`ltr` | Paragraphs are output from left to right.
`rtl` | Paragraphs are ouput from right to left. This is most useful for languages with a right-to-left reading order.
`automatic` | The PDF reader determines the paragraph direction for each PDF page, and then sets the direction accordingly.

## MetadataValueType

A list of the possible value types for metadata items. A value from this enumeration is returned from the function value_type().

Value | Description
--- | ---
`Bool` | A Boolean.
`Int64` | A 64-bit integer.
`Double` | A double.
`DateTime` | Absolute date/time value, as an integral number of epoch seconds.
`TargetEncodingString` | A string presented in your configured target encoding.
`Binary` | Binary data.
`MIPLabel` | Microsoft Information Protection sensitivity label (MIPLabel) type. See The MIPLabel Struct.

## MetadataKey

This enumerated type defines the standard keys that File Content Extraction can use for metadata field standardization. The values from this enumeration are returned by the standard_key method of a MetadataElement. The value `MetadataKey::Other` indicates that a metadata element does not represent a standardized field. This enumeration is defined in `Keyview_Metadata.hpp`. For a list of the standard metadata keys, see Standardized Metadata Elements.

## OCROrientation

The following table lists the values of the `OCROrientation` enumeration.

Value | Description
--- | ---
`Upright` | OCR only attempts to detect text that is upright.
`Any` | OCR attempts to detect text that is upright, or rotated in 90-degree increments from upright.

## OCRTextFindingMode

The following table lists the values of the `OCRTextFindingMode` enumeration.

Value | Description
--- | ---
`Document` | A scanned or printed page of formatted text, such as a report, magazine, or letter.
`Scene` | An image of a general scene that contains text, such as a photograph or TV footage.
`Hollow` | A scene image containing outlined text, such as white characters with a black border which are often used in television subtitles.
`Auto` | The OCR library selects the algorithm automatically.

## OCRDetectAlphabet

The following table lists the values of the `OCRDetectAlphabet` enumeration.

Value | Description
--- | ---
`Off` | OCR does not detect the alphabet.
`Listed` | OCR detects the alphabet, but only considers alphabets that are represented in your chosen list of languages.
`All` | OCR detects the alphabet that is used, and considers all alphabets.

## ShowFormulasAs

The following table lists the values of the `ShowFormulasAs` enumeration.

Value | Description
--- | ---
`ValuesOnly` | Output the cell value only. This is the default.
`FormulasOnly` | Output the formula only.
`ValuesAndFormulas` | Output the cell value and formula.

## SourceCodeIdentificationLevel

The following table lists the values of the `SourceCodeIdentificationLevel` enumeration.

Value | Description
--- | ---
`Off` | Do not enable source code identification.
`Enabled` | Enable source code identification for the most common source code formats. This option can detect formats 498-545, which would otherwise be detected as `ASCII_Text_Fmt`.
`Extended` | Enable source code identification for all supported source code formats. This option might lead to false positives in some cases (for example, a C++ file might get identified as a rarer format). This option can detect formats 498-545, and 749-907, which would otherwise be detected as `ASCII_Text_Fmt`.

## SubFile::Type

The following table lists the values of the `SubFile::Type` enumeration.

Value | Description
--- | ---
`Main` | The subfile is at the top level of the main file. This is the default subfile type.
`Attachment` | The subfile is an attachment in a file.
`OLE` | The subfile is an embedded OLE object in a compound document.
`Folder` | The subfile is a folder or the artificial root node.
`Uncategorised_Image` | An embedded image that has not been categorized by the reader.
`Embedded_Image` | An embedded image.
`Embedded_Icon` | An icon used to represent an embedded file.
`Embedded_Content` | An image used to represent content for an embedded file. This could be an preview image of the actual content, or another representation such as an icon.
`Embedded_Preview` | A preview of an embedded file. This is usually an image that shows part of the embedded file.
`XrML` | The subfile contains the XrML that describes the RMS protection used on an RMS-encrypted main file.

NOTE: The enumeration `SubFile::Type` is a scoped enumeration, as well as being a member of class `Subfile`. Therefore, you must always refer to the values by using a full qualification. For example:

    if(subfile.type() == SubFile::Type::Folder)

NOT

    if(subfile.type() == Folder)

## SubfileChecksumType

Value | Description
--- | ---
`None` | The container does not store a checksum for the subfile, or File Content Extraction is not able to read it.
`CRC32` | A CRC32 checksum.

## SummaryInfoType

DEPRECATED: The `SummaryInfoType` enumeration is deprecated in File Content Extraction 23.2.0 and later.

The `SummaryInfoType` enumeration has the following values:

`Bool`
`Int`
`Double`
`TargetEncodingString`
`Utf8String`
`DateTime`

NOTE: The enumerator names for `SummaryInfoType` are generic, so `SummaryInfoType` is a scoped enumeration; that is, you must always refer to the values by using a qualification with the enumeration name. For example:

    if(item.type() == SummaryInfoType::Double)

NOT

    if(item.type() == Double)

Copyright 1997-2024 Open Text
Version 25.1 | Last updated January 2025

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: File Content Extraction 25.1

Topic Title: Enumerations