LFileSettings::IgnoreFilters

#include "ltwrappr.h"

static L_INT LFileSettings::IgnoreFilters(pszFilters)

L_TCHAR L_FAR * pszFilters;

/* character string containing filters */

Specifies which file filters LEADTOOLS should NEVER load, even if present.

Parameter

Description

pszFilters

Character string containing which filters should be ignored and therefore not loaded. pszFilters has the same format as in LFileSettings::PreLoadFilters .

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Use this function if you never want to load a particular file filter(s). This is useful for instance if you never load AVI files and you want to ignore the AVI filter since this filter on its own loads all the DLLs required for Video for Windows (there are about 10 of them).

The files specified in LFileSettings::PreLoadFilters take priority over the files specified in LFileSettings::IgnoreFilters. This means that if the filter is present in pszFilters for both methods, then the filter will be loaded and will not be ignored.

Note that LFileSettings::IgnoreFilters has effect only if called prior to loading, saving or getting information about a file. In addition, LFileSettings::PreLoadFilters must be called before LFileSettings::IgnoreFilters for LFileSettings::IgnoreFilters to work properly. For more information, refer to Loading File Filters.

Required DLLs and Libraries

LTFIL

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

LFileSettings::PreLoadFilters, Class Members

Topics:

Raster Image Functions: Input/Output File Filters, Files To Be Included With Your Application

Example

L_VOID  TestFunction()
{
   LFileSettings fileSettings;

   //Ignore CMP filter
   fileSettings.IgnoreFilters(TEXT("CMP"));

   //…
}