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 右对齐

 

 

你可能感兴趣的:(label)