| 继承自 | SKNode:UIResponder:NSObject |
| 符合 | NSCoding(SKNode) NSCopying(SKNode) NSObject(NSObject) |
| 框架 | /System/Library/Frameworks/SpriteKit.framework |
| 可用性 | 可用于iOS 7.0或者更晚的版本 |
| 声明于 | SKLabelNode.h |
| 参考指南 | Sprite Kit Progamming Guide |
概览
| 重要提示：这是一个初步的API或者开发技术文档。虽然已经审阅了本文档的技术准确性，但是它不是最终的版本。本机密信息仅适用于苹果开发者计划的注册会员。苹果提供这些机密信息来帮助你采用这些技术和编程接口。此信息如果有变更，根据本文档实现的软件应使用操作系统软件和最终文档测试。新版本的文档可能会拥有新的API或者技术。 |
一个SKLabelNode是一个绘制字符串的节点。
要使用标签节点，首先通过调用labelNodeWithFontNamed:方法创建一个新的标签节点。然后配置标签的其他属性，尤其是text属性。
节点的大小由节点的fontName属性，fontSize属性，和text属性共同的隐蔽的决定。默认情况下，文字相对于节点的原点水平居中，字体的基线穿过原点。verticalAlignmentMode属性和horizontalAlignmentMode属性可以调整标签相对于原点的位置。
方法
创建一个新的标签节点。
| - initWithFontNamed: |
初始化一个新的标签对象。
- (id)initWithFontNamed:(NSString *)fontName
| 参数 | fontName:标签所用字体的名字 |
| 返回值 | 一个标签实例 |
| + labelNodeWithFontNamed: |
创建一个新的标签对象。
+ (id)labelNodeWithFontNamed:(NSString *)fontName
| 参数 | fontName:标签所用字体的名字 |
| 返回值 | 一个新的标签实例 |
属性
配置标签的信息。
| text |
标签显示的字符串。
@property(atomic, copy) NSString *text
配置标签的字体。
| fontColor |
标签的颜色。
@property(atomic, retain) SKColor *fontColor
| fontName |
标签文本所用的字体。
@property(atomic, copy) NSString *text
| fontSize |
标签文本的字体大小。
@property(atomic) CGFloat *fontSize
配置标签的位置。
| verticalAlignmentMode |
文本相对于节点的垂直位置。
@property(atomic) SKLabelVerticalAlignmentMode verticalAlignmentMode
论述
详细熟悉值参见常量部分，该属性的默认值为SKLabelVerticalAlignmentModeBaseLine。
| horizontalAlignmentMode |
文本相对于节点的水平位置。
@property(atomic) SKLabelHorizontalAlignmentMode horizontalAlignmentMode
详细熟悉值参见常量部分，该属性的默认值为SKLabelHorizontalAlignmentModeCenter。
执行颜色混合。
| color |
标签的混合颜色。
@property(atomic, retain) SKColor *color
| colorBlendFactor |
一个用于描述字体颜色如何混合的浮点值。
@property(atomic) CGFloat colorBlendFactor
论述
这个值必须在0.0到1.0之间。默认值为0.0，表示该属性将被忽略，标签的颜色属性将不被修改。如果该值大于0.0，字体颜色将首先与混合色混合。
将标签混合到父缓冲区。
| blendMode |
该属性将标签混合输出到父缓冲区。
@property(atomic) SKBlendMode blendMode
论述
默认值为SKBlendModeAlpha。
常量
文本垂直对齐模式。
typedef NS_ENUM(NSInteger,
SKLabelVerticalAlignmentMode){
SKLabelVerticalAlignmentModeBaseLine = 0,
SKLabelVerticalAlignmentModeCenter = 1,
SKLabelVerticalAlignmentModeTop = 2,
SKLabelVerticalAlignmentModeBottom = 3,
}
| SKLabelVerticalAlignmentModeBaseLine | 字体基线穿过原点 |
| SKLabelVerticalAlignmentModeCenter | 相对于原点垂直居中 |
| SKLabelVerticalAlignmentModeTop | 顶部对齐 |
| SKLabelVerticalAlignmentModeBottom | 底部对齐 |
文本水平对齐模式。
typedef NS_ENUM(NSInteger,
SKLabelHorizontalAlignmentMode){
SKLabelHorizontalAlignmentModeCenter = 0,
SKLabelHorizontalAlignmentModeLeft = 1,
SKLabelHorizontalAlignmentModeRigh = 2,
}
| SKLabelHorizontalAlignmentModeCenter | 相对于原点水平居中 |
| SKLabelHorizontalAlignmentModeLeft | 左对齐 |
| SKLabelHorizontalAlignmentModeRight | 右对齐 |