![]() |
FNSProfileRemoveIndReference |
||||
Header: | FontSync.h | Carbon status: | Supported | |
Deletes an indexed font reference from a profile.
OSStatus FNSProfileRemoveIndReference ( FNSFontProfile iProfile, UInt32 iIndex );
A reference to the font profile whose indexed font reference you want to delete. The profile must be writable.
An index into the list of font references in the profile. Pass a value between 0 and one less than the number of references in the profile, returned by the function FNSProfileCountReferences. Note that this will change the indices of all succeeding references.
A result code. The result code kFNSBadProfileVersionErr indicates that a font profile has an unsupported format version. This may indicate that the profile is valid, but created by a later version of FontSync, or that the profile is truly invalid. The result code kFNSInvalidProfileErr indicates that a profile does not have a valid structure. The result code permErr indicates that a specified file is locked and not writable. The result code kFNSBadReferenceVersionErr indicates that a font reference has an unsupported format version. This may indicate that the reference is valid, but created by a later version of FontSync, or that the reference is truly invalid. The result code kFNSInvalidReferenceErr indicates that a font reference is invalid. The result code inputOutOfBounds indicates that the specified index was out of range. The File Manager error permErr indicates that the file is either locked and not editable or opened for read-only access. FNSProfileRemoveIndReference may return other File Manager errors. Memory Manager errors indicate that you did not have enough memory available in your heap.
The FNSProfileRemoveIndReference function deletes an indexed font reference from an editable profile. The reference must be identical to the reference specified in the iReference parameter. A matching reference is not enough, since not all the data in a font reference is examined when a matching operation is performed.
You can use either FNSProfileRemoveIndReference or the function FNSProfileRemoveReference to remove a font reference, depending upon what you know about the reference. If you know its value, call FNSProfileRemoveReference. If you know its index in the list of font references, call FNSProfileRemoveIndReference.
Available beginning with FontSync 1.0.
Supported in Carbon. Available in Carbon 1.0.2 and later when Font Sync 1.0 or later is present.
© 2000 Apple Computer, Inc. (Last Updated 7/13/2000)