SKLabelNode类

继承自	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	右对齐