跳转到内容

core.ui.menubar

此模块为终端 UI 系统提供菜单栏组件。

提示

使用此模块需要先导入:import("core.ui.menubar")

注意

UI 模块主要用于 xmake 内部的 xmake f --menu 菜单可视化配置。它提供基础的 UI 组件,当然,用户也可以用来实现一些自己的终端 UI。

menubar 模块继承自 panel,提供菜单栏显示。

  • 创建新的菜单栏实例

函数原型

API

lua
menubar:new(name: <string>, bounds: <rect>)

参数说明

参数描述
name必需。菜单栏名称字符串
bounds必需。菜单栏边界矩形

返回值说明

类型描述
menubar返回菜单栏实例

用法说明

创建菜单栏:

lua
import("core.ui.menubar")
import("core.ui.rect")

local menubar = menubar:new("menubar", rect{1, 1, 80, 1})
  • 获取标题标签

函数原型

API

lua
menubar:title()

参数说明

无参数

返回值说明

类型描述
label返回标题标签实例

用法说明

访问并自定义标题标签:

lua
local title = menubar:title()
title:text_set("My Application")
title:textattr_set("red bold")

以下是一个完整的菜单栏使用示例:

lua
import("core.ui.menubar")
import("core.ui.window")
import("core.ui.rect")
import("core.ui.application")

local demo = application()

function demo:init()
    application.init(self, "demo")
    self:background_set("blue")
    
    -- 创建菜单栏
    local menubar = menubar:new("menubar", rect{1, 1, self:width() - 1, 1})
    menubar:title():text_set("Xmake Demo Application")
    menubar:title():textattr_set("red bold")
    
    -- 创建主窗口
    local win = window:new("main", rect{1, 2, self:width() - 1, self:height() - 2}, "主窗口")
    
    -- 添加到应用程序
    self:insert(menubar)
    self:insert(win)
    
    self._menubar = menubar
    self._win = win
end

function demo:on_resize()
    self._menubar:bounds_set(rect{1, 1, self:width() - 1, 1})
    self._win:bounds_set(rect{1, 2, self:width() - 1, self:height() - 2})
    application.on_resize(self)
end

function main(...)
    demo:run(...)
end