OdPrcHostAppServices::findFile Method
Syntax
C++
virtual OdString findFile(const OdString& filename, OdDbBaseDatabase* pDb = 0, FindFileHint hint = kDefault);
Description
DescriptionReturns the fully qualified path to the specified file.
Parameters|
Parameters |
Description |
|
filename |
[in] A name of the file to find. |
|
pDb |
[in] A pointer to the database context. If the parameter value is equal to NULL, then the file search is not related with a database. |
|
hint |
[in] A hint that indicates the type of file that is required. |
RemarksReturns an empty string if the file is not found.
This method is called by PRC SDK when access is needed to a file, such as a font file, a template file, etc.
If pDb parameter value is not equal to NULL, call pDb->getFilename() to determine the path to the .prc file associated with the database.
The typical search order is as follows:
- The file name itself.
- The current directory.
- The drawing directory (for shx font, image, and xref files).
- The Windows fonts directory (only for TTF fonts on Windows).
The hint parameter must be one of the following:
|
Name |
Value |
Description Extension |
|
kDefault |
0 |
Any file. any |
|
kFontFile |
1 |
Can be either SHX or TTF file. SHX or TTF |
|
kCompiledShapeFile |
2 |
SHX file. SHX |
|
kTrueTypeFontFile |
3 |
TTF file. TTF |
|
kEmbeddedImageFile |
4 |
Image file. ISM |
|
kXRefDrawing |
5 |
External reference file. |
|
kPatternFile |
6 |
Pattern file (PAT) PAT |
|
kDRXApplication |
7 |
DRX application file. DRX |
|
kFontMapFile |
8 |
FontMap file. FMP |
Links