NAppGUI控件使用指南从按钮到表格20内置原生控件一网打尽【免费下载链接】nappgui_srcSDK for building cross-platform desktop apps in ANSI-C项目地址: https://gitcode.com/gh_mirrors/na/nappgui_srcNAppGUI 是一款用纯 ANSI-C 编写的跨平台桌面应用 SDK一套代码就能在 Windows、macOS 和 Linux 上构建图形界面程序。它内置了 20 多种原生风格的 GUI 控件——从最常用的按钮Button、文本框Edit到复杂的表格视图TableView——全部以统一的 C 函数 API 提供不依赖任何重量级框架。本文带你快速认识这些控件的分工以及如何用最少的代码把它们组合成一个完整的桌面应用界面。一、NAppGUI 内置控件全景图所有 GUI 控件的接口都集中在src/gui/目录下每个控件都有独立的头文件。你可以从 guiall.h 一次性引入全部接口。下表是核心控件速览控件用途头文件Button普通按钮、复选框、单选框、扁平图标按钮button.hEdit单行/多行文本输入edit.hCombo下拉选择框combo.hListBox列表选择框支持图标、多选listbox.hTableView高性能数据表格tableview.hTextView大文本/日志显示textview.hWebView内嵌网页视图webview.hImageView图片显示imageview.hSlider / UpDown滑块、数字调节框slider.hProgress进度条progress.hTabs / SplitView选项卡、可拖拽分割窗格tabs.hMenu / PopUp菜单栏、弹出菜单menu.hLabel / Line / Panel标签、分隔线、容器面板label.hWindow / Layout / Cell窗口、网格布局、单元格布局window.h 所有控件类型的前向声明都汇总在 gui.hxx 中这也是理解控件体系结构的最佳入口。二、窗口 布局控件的骨架在放置任何控件之前先要搭好骨架创建窗口window_create()得到Window并设置标题、大小、图标创建布局layout_create(cols, rows)生成网格布局再用layout_button()、layout_edit()等函数把控件放进指定格子设置自适应通过layout_hexpand()/layout_vexpand()让某一行或一列自动伸缩这是做出随窗口拉伸界面的关键。官方示例 baslayout.c 和 layoutbind.c 演示了从固定布局到动态重排的完整过程强烈建议按顺序阅读。三、按钮 Button一个类型五种形态Button 是 NAppGUI 中一控件多形态的典型。查看 button.h 可以发现它内置了 6 种创建函数button_push()—— 普通点击按钮button_check()/button_check3()—— 复选框含三态button_radio()—— 单选按钮button_flat()/button_flatgle()—— 无边框的扁平图标按钮配置函数遵循统一的button_xxx(控件, 参数)命名例如设置文字用button_text()、绑定图标用button_image()、悬停提示用button_tooltip()点击事件则通过button_OnClick()注册监听器。buttons.c 这个演示文件一次性展示了全部五种形态一排带图标的扁平按钮工具条、一组单选按钮、一组复选框、以及带默认按钮的操作区。四、输入类控件Edit、Combo、Slider、UpDown表单类控件是桌面应用的高频需求NAppGUI 提供了完整组合Editedit.h可切换单行/多行模式支持密码模式、文本选择监听还能配置语法高亮接近一个轻量代码编辑器Combocombo.h通过combo_editable()决定纯下拉还是可输入combo_OnFilter()支持输入时实时过滤选项Slider / UpDown滑块与数字步进框天然适配音量、数量这类参数调节场景Popuppopup.h轻量弹窗输入框适合输入一个文件名这种快速交互。表单类演示可直接参考 form.c 与 editpad.c。五、TableView 表格控件NAppGUI 的明星控件如果需要展示成百上千行数据TableView 是不二之选。它的关键设计是数据懒加载——控件本身不存储任何数据而是通过tableview_OnData()回调向你的数据源按需取数。查看 tableview.h核心能力包括列配置tableview_add_column_text()加列配合tableview_column_width()、tableview_column_align()控制宽度与对齐tableview_column_freeze()冻结前几列表头tableview_header_title()设置标题tableview_OnHeaderClick()监听表头点击常用于排序样式tableview_row_height()、tableview_grid()调整行高与网格线单元格内还能嵌入图标选择tableview_multisel()开启多选tableview_OnSelect()获取选中行。官方表格演示 table.c 中i_OnTableData回调根据事件类型返回总行数或具体单元格内容100 行数据在滚动时按需填充——这正是TableView 高性能的秘密。产品管理应用 products/ 则是列表 表格 编辑完整业务场景的参考实现。六、显示类控件TextView、ImageView、WebView数据展示三件套TextView只读大文本区域适合日志、说明文档ImageView显示图片并支持缩放适配imageview.hWebView基于系统 Web 内核嵌入网页Linux 下基于 WebKit、Windows 下基于系统组件跨平台体验一致webview.h。drawhello.c 与 webhello.c 分别演示了 2D 绘图输出和网页嵌入。七、容器与进阶Tabs、SplitView、Menu界面变复杂后需要容器来组织Tabstabctrls.c选项卡切换是 GuiHello 演示程序的主导航SplitViewsplitview.h用户可拖拽的分栏做左列表右详情布局非常顺手参考 splits.cMenu / MenuItem构建菜单栏与右键弹出菜单支持快捷键见 dynmenu.cProgress / Line / Label进度条、分隔线、文本标签细节装饰全靠它们。八、最佳学习路径GuiHello 综合演示想一次性看到所有控件的活法直接运行 GuiHello 演示是最快的方式——它在一个选项卡式窗口里收纳了 20 多个面板从标签、按钮到表格、分割窗格逐一演示入口在 guihello.c// 构建并运行Linux 示例 git clone --depth 1 https://gitcode.com/gh_mirrors/na/nappgui_src cd nappgui_src cmake -S . -B build -DCMAKE_BUILD_TYPEDebug cmake --build build -j 4 ./build/Debug/bin/GuiHello其他值得运行的演示演示侧重点入口GuiHello全量控件综合演示demo/guihello/Products表格 列表 菜单的业务应用demo/products/DrawHello2D 绘图与图像demo/drawhello/Bricks完整小游戏事件循环实战demo/bricks/小结NAppGUI 的控件体系设计得非常克制而实用统一命名控件名_操作()的函数风格记住一个控件的规则就能推会全部事件驱动所有交互通过xxx_OnEvent()注册监听器回调里处理业务布局先行先建 Layout/Panel再把控件装进格子界面自动适配窗口尺寸原生风格三大平台上均呈现系统原生外观用户无需适应。从 src/gui/ 的接口定义到 demo/guihello/ 的完整示例跟着读头文件 → 跑演示 → 改演示三步走你就能用纯 C 语言快速搭出自己的跨平台桌面应用。【免费下载链接】nappgui_srcSDK for building cross-platform desktop apps in ANSI-C项目地址: https://gitcode.com/gh_mirrors/na/nappgui_src创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考