This function permanently removes a font or font instance from the Font Catalog of the specified Standard Engine instance.
Parameter | Description |
---|---|
font_index |
Font index of the font or font instance to be removed from the Font Catalog. |
If successful, the function returns 1. Otherwise, the function returns 0
An application can use the FontRemove function to permanently remove a font or font instance from the Font Catalog when it is no longer needed. Once the specified font or font instance is removed, the value of font_index becomes invalid and any future references to that index are not allowed. Your application must ensure that the removed font index is not referenced or used any more, otherwise unexpected results might occur.
Of course, any other fonts or font instances that are still in the Font Catalog will keep their unique font indexes after FontRemove returns.
Applications should use this function only when a font or font instance should be permanently removed from the Font Catalog. If there is a chance that the referenced font or font instance will be used again in the future, it is better to just make it inactive using the FontMakeInactive function.