更进一步

初步入门教程到这里就结束了，要了解 LaGUI 的更进一步用法，请参阅附带的 LaGUI 示例程序包，以及其他的用 LaGUI 制作而成的应用程序，例如“Our Paint”。您也可以在代码仓库提出工单以确认更多未在教程中明确解释的操作。

显示数值控件

LaGUI 的所有数值控件均需要数据源才能显示。因此我们需要为您应用程序的业务数据注册数据的访问方式，这个“访问方式”在 LaGUI 中定义成一条条的属性。

通过您定义的属性，LaGUI 还自动管理数据的撤销和重做，也包括资源文件的读写。交由 LaGUI 撤销系统、修改记录系统和共享资源系统来管理的数据必须使用 LaGUI 的内存调用来分配。在接下来的例子中，我们只需要用到界面显示，因此涉及不到这些复杂用法。

最简单的属性定义例子

例如我们有这样一个全局的 C 定义：

typedef struct My{ int _pad; laSafeString* Name; int Age; int Gender; real Height; } My; My Stats;

在 LaGUI 中，C Struct 相当于 laPropContainer 。我们首先创建一个适用于 My 类型的 laPropContainer ：

laPropContainer* my=laAddPropertyContainer("my", "My", "Struct My",0,0,0,0,0,LA_PROP_OTHER_ALLOC);

由于所有 My 实例（在这里只有一个 My Stats;）的内存都不由 LaGUI 分配，因此在最后一个参数必须设置 LA_PROP_OTHER_ALLOC 以告知 LaGUI ，同时由于在这个例子中我们不需要 LaGUI 创建或者删除 My 实例，也不需要赋值 NodeSize 参数。

接下来我们就可以向 my 这个 laPropContainer 中添加各个属性，使用对应的 laAddxxxxProperty() 函数。这个例子足够简单，我们不需要 get/set 回调，因此只需提供成员相对于 My 的首地址偏移量。

laAddStringProperty(my, "name", "Name", "My name",0,0,0,0,1,offsetof(My,Name),0,0,0,0,0); laAddIntProperty(my, "age", "Age", "My age",0,0,"years old",100,0,1,25,0,offsetof(My,Age),0,0,0,0,0,0,0,0,0,0,0); laAddFloatProperty(my, "height", "Height", "My height",0,0,"cm",2,0.3,0.01,1.76,0,offsetof(My,Height),0,0,0,0,0,0,0,0,0,0,0); laProp* ep=laAddEnumProperty(my, "gender","Gender","My gender",0,0,0,0,0,offsetof(My,Gender),0,0,0,0,0,0,0,0,0,0); laAddEnumItemAs(ep,"MALE","Male","Gender being male",0,L'♂'); laAddEnumItemAs(ep,"FEMALE","female","Gender being female",1,L'♀');

注意到 laSafeString* Name; 不是 char[] ，LaGUI 提供了 laSafeString 的便利功能，只需在注册属性时将 IsSafeString 参数置为非0。

此外，我们要告诉 LaGUI 我们业务数据的根，这样 LaGUI 才能找到第一个 my 的实例（在这个例子中只有一个）。

laPropContainer* root=laDefineRoot(); laAddSubGroup(root,"me","Me","Me root", "my", 0,0,0,0,myget_Stats,0,0,0,0,0,0,0);

属性到这里就注册完成了，现在可以在界面上显示刚才注册的这些属性：

void MyProperties(laUiList *uil, laPropPack *This, laPropPack *DetachedProps, laColumn *UNUSED, int context){ laColumn* c=laFirstColumn(uil); laShowLabel(uil,c,"Hello world!",0,0); laShowItem(uil,c,0,"me.name"); laShowItem(uil,c,0,"me.age"); laShowItem(uil,c,0,"me.height"); laShowItem(uil,c,0,"me.gender"); }

属性注册与面板注册的先后顺序无所谓。之后，对 My Stats; 的值初始化之后，就能够运行程序了。你可以通过控件修改这些属性的值，如果通过“🞆”菜单调出一个新的“Properties”面板，你可以观察到两个面板上的属性同步刷新。

属性简易示例程序的代码应该类似于这样：

#include "la_5.h" extern LA MAIN; typedef struct My{ int _pad; laSafeString* Name; int Age; int Gender; real Height; } My; My Stats; void* myget_Stats(void* unused, void* unused1){ return &Stats; } void MyProperties(laUiList *uil, laPropPack *This, laPropPack *DetachedProps, laColumn *UNUSED, int context){ laColumn* c=laFirstColumn(uil); laShowLabel(uil,c,"Hello world!",0,0); laShowItem(uil,c,0,"me.name"); laShowItem(uil,c,0,"me.age"); laShowItem(uil,c,0,"me.height"); laShowItem(uil,c,0,"me.gender"); } int main(int argc, char *argv[]){ laGetReady(); Stats.Age=25; Stats.Gender=0; Stats.Height=1.76; strSafeSet(&Stats.Name,"ChengduLittleA"); laPropContainer* root=laDefineRoot(); laAddSubGroup(root,"me","Me","Me root", "my", 0,0,0,0,myget_Stats,0,0,0,0,0,0,0); laPropContainer* my=laAddPropertyContainer("my", "My", "Struct My",0,0,0,0,0,LA_PROP_OTHER_ALLOC); laAddStringProperty(my, "name", "Name", "My name",0,0,0,0,1,offsetof(My,Name),0,0,0,0,0); laAddIntProperty(my, "age", "Age", "My age",0,0,"years old",100,0,1,25,0,offsetof(My,Age),0,0,0,0,0,0,0,0,0,0,0); laAddFloatProperty(my, "height", "Height", "My height",0,0,"cm",2,0.3,0.01,1.76,0,offsetof(My,Height),0,0,0,0,0,0,0,0,0,0,0); laProp* ep=laAddEnumProperty(my, "gender","Gender","My gender",0,0,0,0,0,offsetof(My,Gender),0,0,0,0,0,0,0,0,0,0); laAddEnumItemAs(ep,"MALE","Male","Gender being male",0,L'♂'); laAddEnumItemAs(ep,"FEMALE","female","Gender being female",1,L'♀'); laRegisterUiTemplate("my_properties","Properties", MyProperties,0,0,"Demonstration", 0,0,0); // Uncomment this to load preferences. // laEnsureUserPreferences(); if(!MAIN.Windows.pFirst){ laWindow* w = laDesignWindow(-1,-1,600,600); laLayout* l = laDesignLayout(w,"My Layout"); laCreatePanel(l->FirstBlock,"my_properties"); laStartWindow(w); } laMainLoop(); }

属性定义参考

LaGUI 支持的属性类型如下表所示：

属性类型 对应 C 类型 LaGUI 控制的操作 LA_PROP_INT 32位整数 读、写、数组、显示 LA_PROP_FLOAT 64位浮点数 读、写、数组、显示 LA_PROP_ENUM 8/16/32位整数 读、写、数组、显示 LA_PROP_STRING 8位整数数组或 laSafeString* 读、写、显示 LA_PROP_SUB 64位地址或 laListHandle 写指针、读指针和偏移、读写列表、显示列表和成员 LA_PROP_RAW 64位地址 （仅通过回调在文件读写时访问） LA_PROP_OPERATOR - 通过 This 的工具调用1

1: 目前属性路径必须仅包含工具属性标识符，否则不工作。

LA_PROP_SUB 属性可递归包含，因此可以以树状方式描述整个应用程序的数据结构。下面这个对照示意解释了一种简易文件树结构的可能注册方式。建议通过各个 LaGUI 示例程序以及“Our Paint”软件的源代码更详细地了解向 LaGUI 描述您业务数据结构的方法。

数据结构 | 属性注册样式 | struct Folder{ | laListItem Item; | SUB "folder" char Name[128]; | STRING "name" int Privileges; | INT "privileges" laListHandle SubFolders; | SUB_PROP LIST "folders" of "folder" laListHandle Files; | SUB_PROP LIST "files" of "file" }; | | struct File{ | laListItem Item; | SUB "file" char Name[128]; | STRING "name" int Size; | INT "size" void* Data; | RAW "data" }; | | struct FileBrowser{ | SUB "application" int SomeOtherStuff; | SUB_PROP LIST "folders" of "folder" laListHandle SubFolders; | }; | | SUB "(__LAGUI_ROOT__)" | SUB_PROP "my_application" of "application"

Art

The Continent Comic: Rescuer Comic: Flight 811

Computer Programs

Our Paintv0.1b LaGUI Line Art LaMDWiki GPencil Font Plugin

Utility Programs

Go check out the code repository.

Featured

Our Paintv0.1b LaGUI Blender Line Art laMDWiki User Manual And Log GPencil Font Plug-in Manual And Log

Earlier works

Rastiq Small Car Simple Desk Stopper

Stashed

Retopology with monte-carlo method Palette for MyPaint Pan-cloud-travel website ESP32 typewriter Hardware progress Line Art embree experiment (done) Blender Nurbs Keyable fully-automatic projectile launching effect tool , based on Blender. 尝试实现一个简单的实时大气光散射

Concepts

The conceptual problem of parametric shape forming