最新版ccs-lua库api 支持2.2.2和自改版2.2.1

编辑Markdown

CCS的lua库api

tags: ccs

framework.ccs

ccs基础库,将ccs的gui类封装到了lua.

• ccs.layer

  创建一个UILayer层

  用法示例:

    local layer = ccs.Layer()

• ccs.widget

  ccs的基础控件

  对应消息类型:ccs.TouchEventType

  格式: widget = ccs.widget(参数表格对象)

  参数表格对象:

    enabled:"设置控件的可用状态,如果为true,widget响应touch并且可见,若为false,则控件不可见并且不响应touch(可选)",
    visable:"设置控件的可见状态(可选)",
    touch:"设置控件是否响应touch,不设置则默认为true(可选)",
    bright:"设置控件是否为高亮状态(可选)",
    foucs:"设置控件是否为焦点(可选)",
    z:"设置控件的层级(可选)",
    tag:"设置控件的标签(可选)",
    color:"设置控件的颜色(可选)",
    size:"设置控件的大小,CCSize类型(可选)",
    sType:"设置控件的尺寸类型(可选)",
    pType:"设置控件的布局(可选)",
    x,y:"坐标",
    name:"名字",
    listener:"回调函数表,是一个table,key值是ccs的消息类型,value为回调函数"

  用法示例:

    local widget = ccs.widget({
        size  = CCSizeMake(200,200),
        x = 100,
        y = 200,
        listener = { 
        [ccs.TouchEventType.began] = function(uiwidget) cclog(“widget touch down”) end,
        [ccs.TouchEventType.ended] = function(uiwidget) cclog(“widget touch ended”) end}, --"这里的回调函数是带参的,[uiwidget]是返回调用回调函数的widget."
  })

• ccs.button

  ccs的按键控件,可以设置三态图片

  格式: button = ccs.button(参数表格对象)

  参数表格对象

    normal:"普通状态的图片",
    pressed:"按下状态的图片(可选)",
    disabled:"禁用状态的图片(可选)",
    scale9:"是否开启9宫格模式(可选) 默认为不开启",
    capInsets:"切片规格,只在开启9宫格模式下有用(可选)",
    text:"按键内显示的文本信息(可选)",
    "[widget]的所有参数",

  用法示例:

    local button = ccs.button({
        normal = "button_n.png",
        pressed = "button_p.png",--ccs的button如果不设置pressed图片,那么在按下之后会没有图片显示
        disabled = "button_d.png",
        text = "这是一个按键",
        scale9 = true,
        listener = { 
        [ccs.TouchEventType.began] = function(uiwidget) uiwidget:setText("widget touch down") end,
        [ccs.TouchEventType.ended] = function(uiwidget) uiwidget:setText("widget touch ended") end }
        })

• ccs.label

  创建一个文本控件

  格式: label = ccs.label(参数表格对象)

  参数表格对象

    text:"label文本(可选)",
    font:"字体(可选)",
    fontSize:"字号(可选)",
    "[widget]的所有参数"

  用法示例:

    local lable = ccs.label({
        text = "this is a label"
    })

• ccs.TextArea

  创建一个文本区,等价于label,只是参数多了些

  格式: textArea = ccs.TextArea(参数表格对象)

  参数表格对象

    H_alignment:"水平对齐方式",
    V_alignment:"竖直对齐方式",
    "[label]的所有参数"

• ccs.labelAtlas