# gdip.privateFontCollection 库模块帮助文档

## gdip 成员列表 <a id="gdip" href="#gdip">&#x23;</a>

### gdip.privateFontCollection() <a id="gdip.privateFontCollection" href="#gdip.privateFontCollection">&#x23;</a>
私有字体集合,调用时不应在参数中指定指针  
较老的系统在私有字体集合释放后,会导致该容器加载并仍在使用的的字体异常  
稳妥的方式是调用 gdip.privateFontCollection.getInstance 函数  
获取私有字体集合的单一实例  

[返回对象:gdipprvfontcollObject](#gdipprvfontcollObject)

## gdip.privateFontCollection 成员列表 <a id="gdip.privateFontCollection" href="#gdip.privateFontCollection">&#x23;</a>

私有字体集合,  
请在 fonts 命名空间下添加库,并调用 fonts.createFamily 函数注册嵌入字体

### gdip.privateFontCollection.createFamily(字体路径,字体名) <a id="gdip.privateFontCollection.createFamily" href="#gdip.privateFontCollection.createFamily">&#x23;</a>
创建字体家族,创建失败返回空值  
参数@1可以是路径或资源文件、内存数据  
如果不指定名字,则返回字体列表中的第一个字体家族

### gdip.privateFontCollection.createFont(字体路径,字体名,大小,样式,单位) <a id="gdip.privateFontCollection.createFont" href="#gdip.privateFontCollection.createFont">&#x23;</a>
创建字体  
参数@1可以是路径或资源文件、内存数据  
单位默认为像素

### gdip.privateFontCollection.getInstance() <a id="gdip.privateFontCollection.getInstance" href="#gdip.privateFontCollection.getInstance">&#x23;</a>
获取默认的私有字体集合,  
较老的系统在私有字体集合释放后,会导致该容器加载并仍在使用的的字体异常,  
 稳妥的方式是调用此函数获取单一实例的自定义容器  
aardio 会在程序结束前自动释放此容器对象,  
但手动调用此对象的 delete 函数将被忽略,  

[返回对象:gdipprvfontcollObject](#gdipprvfontcollObject)

## gdipprvfontcollObject 成员列表 <a id="gdipprvfontcollObject" href="#gdipprvfontcollObject">&#x23;</a>

### gdipprvfontcollObject.add <a id="gdipprvfontcollObject.add" href="#gdipprvfontcollObject.add">&#x23;</a>
添加自字义字体

### gdipprvfontcollObject.add(字体) <a id="gdipprvfontcollObject.add" href="#gdipprvfontcollObject.add">&#x23;</a>
参数可以是字体文件,资源文件  
或字体文件加载到内存的数据

### gdipprvfontcollObject.count() <a id="gdipprvfontcollObject.count" href="#gdipprvfontcollObject.count">&#x23;</a>
返回字体列表中包含的字体家族总数,  
一个字体家族可以用于创建不同大小、不同样式的同名字体

### gdipprvfontcollObject.createFamily <a id="gdipprvfontcollObject.createFamily" href="#gdipprvfontcollObject.createFamily">&#x23;</a>
创建字体家族对象

### gdipprvfontcollObject.createFamily("字体名") <a id="gdipprvfontcollObject.createFamily" href="#gdipprvfontcollObject.createFamily">&#x23;</a>
参数为字体名  
如果不指定名字,则返回字体列表中的最后一个添加的字体家族

### gdipprvfontcollObject.createFamily() <a id="gdipprvfontcollObject.createFamily" href="#gdipprvfontcollObject.createFamily">&#x23;</a>
[返回对象:gdipfamilyObject](#gdipfamilyObject)

### gdipprvfontcollObject.delete() <a id="gdipprvfontcollObject.delete" href="#gdipprvfontcollObject.delete">&#x23;</a>
删除字体

### gdipprvfontcollObject.getFamilies <a id="gdipprvfontcollObject.getFamilies" href="#gdipprvfontcollObject.getFamilies">&#x23;</a>
返回字体集合中的字体家族数组,  
一个字体家族可以用于创建不同大小、不同样式的同名字体

### gdipprvfontcollObject.getFamilies(sought,clone) <a id="gdipprvfontcollObject.getFamilies" href="#gdipprvfontcollObject.getFamilies">&#x23;</a>
返回字体集合中的字体家族数组,所有参数可选,  
参数  @sought 指定期望返回的字体家族数目,  
不指定则自动获取全部字体家族并返回,clone参数指定是否复制字体家族对象,  
如果不复制，在字体列表被删除以后，此函数返回的字体家族也不能再使用

### gdipprvfontcollObject.getLastFamily() <a id="gdipprvfontcollObject.getLastFamily" href="#gdipprvfontcollObject.getLastFamily">&#x23;</a>
[返回对象:gdipfamilyObject](#gdipfamilyObject)

### gdipprvfontcollObject.getLastFamily(clone) <a id="gdipprvfontcollObject.getLastFamily" href="#gdipprvfontcollObject.getLastFamily">&#x23;</a>
返回字体集合中的最后一个添加的字体家族,  
可选参数 @sought 指定期望返回的字体家族数目,  
不指定则自动获取全部字体家族并返回,clone参数指定是否复制字体家族对象,  
如果不复制，在字体列表被删除以后，此函数返回的字体家族也不能再使用
