# gdip.family 库模块帮助文档

## gdip 成员列表 <a id="gdip" href="#gdip">&#x23;</a>

### gdip.CreateFontFamilyFromName : <a id="gdip.CreateFontFamilyFromName :" href="#gdip.CreateFontFamilyFromName :">&#x23;</a>
`$.api("GdipCreateFontFamilyFromName","int(ustring name,ptr fontColl,pointer& fontFamily)")`

### gdip.family <a id="gdip.family" href="#gdip.family">&#x23;</a>
字体家族。  
字体家族由具有相同字样（typeface）但字形风格（例如常规、粗体）不同的字体（font）组成。  
已安装或嵌入的字体列表（FontCollection）包含字体家族（Family），  
字体家族可以用于创建不同大小、不同样式的字体（Font）

### gdip.family("字体名称") <a id="gdip.family" href="#gdip.family">&#x23;</a>
创建字体家族。  
字体名参数必须指定不包含 Regular 这种字形风格后缀的字体名称。  
不指定字体名字时，默认为"MS Shell Dlg"。  
字体家族可以用于创建不同样式的同名字体。  
创建失败返回空值。

### gdip.family() <a id="gdip.family" href="#gdip.family">&#x23;</a>
[返回对象:gdipfamilyObject](#gdipfamilyObject)

### gdip.family(字体家族指针,复制对象) <a id="gdip.family" href="#gdip.family">&#x23;</a>
字体家族指针转换为字体家族对象。  
如果参数@2为true,则复制字体家族并在对象销毁时负责回收字体家族  

否则仅绑定指针到对象,这时应当谨慎使用避免字体家族指针被释放

## gdipfamilyObject 成员列表 <a id="gdipfamilyObject" href="#gdipfamilyObject">&#x23;</a>

### gdipfamilyObject.createFont() <a id="gdipfamilyObject.createFont" href="#gdipfamilyObject.createFont">&#x23;</a>
[返回对象:gdipfontObject](https://www.aardio.com/zh-cn/docs/library-reference/gdip/font.html#gdipfontObject)

### gdipfamilyObject.createFont(emSize,style,unit) <a id="gdipfamilyObject.createFont" href="#gdipfamilyObject.createFont">&#x23;</a>
创建字体。  
参数@emSize指定大小,  
可选参数@style 使用 _GdipFontStyle 前缀的常量指定字形样式，默认为 _GdipFontStyleRegular。  
可选参数@unit 指定单位,默认值为_GdipUnitPixel

### gdipfamilyObject.delete() <a id="gdipfamilyObject.delete" href="#gdipfamilyObject.delete">&#x23;</a>
释放对象。  
注意不应手工调用此函数,除非该集合内创建的字体已不再使用

### gdipfamilyObject.getName() <a id="gdipfamilyObject.getName" href="#gdipfamilyObject.getName">&#x23;</a>
返回字体名。  
可选用参数@1指定语言ID，不指定时默认为 LANG_NEUTRAL，  
语言ID设为 0x409 返回英文字体名

### gdipfamilyObject.name <a id="gdipfamilyObject.name" href="#gdipfamilyObject.name">&#x23;</a>
字体名
