How to use Search File Engine

By default, Dtk_API imitates the default software behavior to find files inserted in an assembly.
The search file engine allows you to :

• set your own priorities between following paths :
  • LocalSearch
  • ReadPathSearch
  • AdditionalPathSearch
  • RelativePathSearch
  • BelowPathSearch
  • AbovePathSearch
• add some search paths

You need first to activate the SearchFileEngine :

MyAPI->ActivateSearchFileEngine();

To use priorities you need to remove default priority first

MyAPI->ManageSearchFile(Dtk_SearchFileEnum::Enable);
MyAPI->ClearSearchPriority();

Then activate the path and the priority order : (0 is the first)

MyAPI->SetLocalPathSearchFlag(DTK_TRUE); // activate the search with the local path from the root file.
MyAPI->SetSearchPositionMode(0, Dtk_SearchFileEnum::LocalSearch);
MyAPI->SetInternalReadPathSearchFlag(DTK_TRUE); // activate the search with the full path read from the file.
MyAPI->SetSearchPositionMode(1, Dtk_SearchFileEnum::ReadPathSearch);

To add other search paths with recursivity or not then activate and set priority:

MyAPI->AddSearchPath( Dtk_SearchFileEnum::RootFolderFirstRecursivity, L"E:\\data\\...." );
MyAPI->SetAdditionnalPathSearchFlag(DTK_TRUE); // activate the additionnal path search method
MyAPI->SetSearchPositionMode(3, Dtk_SearchFileEnum::AdditionalPathSearch);