接口参考

kui_c.h · C API · 3/3

按同一接口文件归组浏览,展开条目查看声明、使用说明和版本边界。

阅读相关开发指南 →

这里保留接口声明及来源。逐项运行验证范围以条目记录为准;源文件中的内部实现候选不代表免费 SDK 的交付承诺。

sdk/c/include/kui_c.h
kui_status_message
有对应声明3.61.7C / Go / Rust

取得状态码的静态说明字符串;结果始终非空,不分配内存,无须释放。 输入字符串采用 UTF-8 和显式字节长度;长度 0 表示 strlen,必填名称、选择器、路径及源码不可为 NULL。

kui_c.h
KUI_C_API const char* kui_status_message(KuiStatus s);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:124

反馈此接口问题 →
kui_window_add_event_listener
有对应声明3.61.7C / Go / Rust

按事件名注册窗口监听器并可返回监听编号;once 非零表示只触发一次。回调内事件是借用指针,仅在回调期间有效,不可释放或留待稍后使用。

kui_c.h
KUI_C_API KuiStatus kui_window_add_event_listener(KuiWindow* window, const char* event_name, size_t len, KuiWindowEventFn fn, void* user_data, int once, KuiListenerId* out_id);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:738

反馈此接口问题 →
kui_window_clear_frame_radius
有对应声明3.61.7C / Go / Rust

清除窗口显式圆角半径设置;要求有效窗口句柄。

kui_c.h
KUI_C_API KuiStatus kui_window_clear_frame_radius(KuiWindow* window);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:734

反馈此接口问题 →
kui_window_close
有对应声明3.61.7C / Go / Rust

调用窗口关闭操作;独占窗口句柄仍需按生命周期调用 release。

kui_c.h
KUI_C_API KuiStatus kui_window_close(KuiWindow* w);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:266

反馈此接口问题 →
kui_window_create
有对应声明3.61.7C / Go / Rust

按 KuiWindowProps 创建独占窗口;创建返回时窗口已可见。属性可先清零以采用默认值,opacity=0 按 1.0 处理;若需先隐藏配置,应立即调用 hide。句柄只能 release 一次。

kui_c.h
KUI_C_API KuiStatus kui_window_create (const KuiWindowProps* props, KuiWindow** out);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:240

反馈此接口问题 →
kui_window_get_device_pixel_ratio
有对应声明3.61.7C / Go / Rust

读取窗口设备像素比例。

kui_c.h
KUI_C_API KuiStatus kui_window_get_device_pixel_ratio(KuiWindow* w, float* out_ratio);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:263

反馈此接口问题 →
kui_window_get_devtools_port
有对应声明3.61.7C / Go / Rust

读取窗口 DevTools 服务监听端口;窗口没有 DevTools 服务时返回 NOT_FOUND。

kui_c.h
KUI_C_API KuiStatus kui_window_get_devtools_port(KuiWindow* window, uint16_t* out_port);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:735

反馈此接口问题 →
kui_window_get_devtools_url
有对应声明3.61.7C / Go / Rust

读取窗口的 DevTools 连接 URL。 输出为调用者缓冲区中的 UTF-8:可先以 NULL/0 查询长度,再分配 out_len+1;长度不含 NUL。容量不足返回 BUFFER_TOO_SMALL 并报告所需长度;容量大于 0 时仍写入 NUL 结尾的截断结果。

kui_c.h
KUI_C_API KuiStatus kui_window_get_devtools_url(KuiWindow* w, char* buf, size_t buf_capacity, size_t* out_len);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:275

反馈此接口问题 →
kui_window_get_document
有对应声明3.61.7C / Go / Rust

取得窗口自有文档的计数引用,调用者须 release;该引用可在窗口释放后继续保活文档。窗口不支持附加外部文档。

kui_c.h
KUI_C_API KuiStatus kui_window_get_document(KuiWindow* w, KuiDocument** out);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:248

反馈此接口问题 →
kui_window_get_native_handle
有对应声明3.61.7C / Go / Rust

取得借用的操作系统窗口标识:Windows 为 HWND、macOS 为 NSWindow*、Linux 为 X11 Window;此值不建立独占窗口之外的新所有权。

kui_c.h
KUI_C_API KuiStatus kui_window_get_native_handle(KuiWindow* w, void** out_handle);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:278

反馈此接口问题 →
kui_window_get_position
有对应声明3.61.7C / Go / Rust

读取窗口位置坐标。

kui_c.h
KUI_C_API KuiStatus kui_window_get_position(KuiWindow* w, int* out_x, int* out_y);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:256

反馈此接口问题 →
kui_window_get_size
有对应声明3.61.7C / Go / Rust

读取窗口宽度与高度。

kui_c.h
KUI_C_API KuiStatus kui_window_get_size(KuiWindow* w, int* out_width, int* out_height);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:253

反馈此接口问题 →
kui_window_get_title
有对应声明3.61.7C / Go / Rust

读取窗口标题。 输出为调用者缓冲区中的 UTF-8:可先以 NULL/0 查询长度,再分配 out_len+1;长度不含 NUL。容量不足返回 BUFFER_TOO_SMALL 并报告所需长度;容量大于 0 时仍写入 NUL 结尾的截断结果。

kui_c.h
KUI_C_API KuiStatus kui_window_get_title(KuiWindow* w, char* buf, size_t buf_capacity, size_t* out_len);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:250

反馈此接口问题 →
kui_window_hide
有对应声明3.61.7C / Go / Rust

隐藏指定窗口。

kui_c.h
KUI_C_API KuiStatus kui_window_hide (KuiWindow* w);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:244

反馈此接口问题 →
kui_window_is_maximized
有对应声明3.61.7C / Go / Rust

判断窗口是否处于最大化状态。

kui_c.h
KUI_C_API KuiStatus kui_window_is_maximized(KuiWindow* w, int* out_maximized);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:265

反馈此接口问题 →
kui_window_is_minimized
有对应声明3.61.7C / Go / Rust

判断窗口是否处于最小化状态。

kui_c.h
KUI_C_API KuiStatus kui_window_is_minimized(KuiWindow* w, int* out_minimized);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:264

反馈此接口问题 →
kui_window_is_visible
有对应声明3.61.7C / Go / Rust

读取窗口当前是否可见。

kui_c.h
KUI_C_API KuiStatus kui_window_is_visible(KuiWindow* w, int* out_visible);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:245

反馈此接口问题 →
kui_window_maximize
有对应声明3.61.7C / Go / Rust

将窗口最大化。

kui_c.h
KUI_C_API KuiStatus kui_window_maximize (KuiWindow* w);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:259

反馈此接口问题 →
kui_window_minimize
有对应声明3.61.7C / Go / Rust

将窗口最小化。

kui_c.h
KUI_C_API KuiStatus kui_window_minimize (KuiWindow* w);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:258

反馈此接口问题 →
kui_window_on_resize
有对应声明3.61.7C / Go / Rust

替换窗口尺寸变化回调;传 NULL 可清除当前回调。回调接收宽度、高度及 user_data。

kui_c.h
KUI_C_API KuiStatus kui_window_on_resize(KuiWindow* w, KuiWindowResizeFn fn, void* user_data);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:271

反馈此接口问题 →
kui_window_release
有对应声明3.61.7C / Go / Rust

销毁独占窗口,不能当作引用计数减一;每个窗口句柄恰好调用一次。已取得的计数文档引用可继续保活文档。

kui_c.h
KUI_C_API KuiStatus kui_window_release(KuiWindow* w);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:242

反馈此接口问题 →
kui_window_remove_event_listener
有对应声明3.61.7C / Go / Rust

使用事件名和监听编号移除窗口监听器;编号需要与对应事件类型配对。

kui_c.h
KUI_C_API KuiStatus kui_window_remove_event_listener(KuiWindow* window, const char* event_name, size_t len, KuiListenerId id);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:742

反馈此接口问题 →
kui_window_remove_event_listeners
有对应声明3.61.7C / Go / Rust

移除窗口指定事件名下的所有监听器。

kui_c.h
KUI_C_API KuiStatus kui_window_remove_event_listeners(KuiWindow* window, const char* event_name, size_t len);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:745

反馈此接口问题 →
kui_window_resize
有对应声明3.61.7C / Go / Rust

实际调整操作系统窗口的宽度和高度。

kui_c.h
KUI_C_API KuiStatus kui_window_resize (KuiWindow* w, int width, int height);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:255

反馈此接口问题 →
kui_window_restore
有对应声明3.61.7C / Go / Rust

恢复窗口的正常状态。

kui_c.h
KUI_C_API KuiStatus kui_window_restore (KuiWindow* w);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:260

反馈此接口问题 →
kui_window_set_always_on_top
有对应声明3.61.7C / Go / Rust

设置或取消窗口始终置顶。

kui_c.h
KUI_C_API KuiStatus kui_window_set_always_on_top(KuiWindow* w, int on_top);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:261

反馈此接口问题 →
kui_window_set_frame_radius
有对应声明3.61.7C / Go / Rust

设置窗口边框圆角半径;半径不能为负,window 必须是有效的独占窗口句柄。

kui_c.h
KUI_C_API KuiStatus kui_window_set_frame_radius(KuiWindow* window, float radius);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:733

反馈此接口问题 →
kui_window_set_frameless_sizeable
有对应声明3.61.7C / Go / Rust

设置无边框窗口是否允许调整大小。window 是独占所有权句柄,必须保持有效,不能当引用计数对象复制释放。

kui_c.h
KUI_C_API KuiStatus kui_window_set_frameless_sizeable(KuiWindow* window, int enabled);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:732

反馈此接口问题 →
kui_window_set_opacity
有对应声明3.61.7C / Go / Rust

设置窗口不透明度。

kui_c.h
KUI_C_API KuiStatus kui_window_set_opacity(KuiWindow* w, float opacity);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:262

反馈此接口问题 →
kui_window_set_position
有对应声明3.61.7C / Go / Rust

设置窗口位置坐标。

kui_c.h
KUI_C_API KuiStatus kui_window_set_position(KuiWindow* w, int x, int y);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:257

反馈此接口问题 →
kui_window_set_script_engine
有对应声明3.61.7C / Go / Rust

在主线程给窗口关联一个借用的脚本引擎;engine 为 NULL 可解除关联。窗口不接管该句柄,引擎必须在被窗口使用期间保持有效;未启用脚本返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_window_set_script_engine(KuiWindow* window, KuiScriptEngine* engine);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:819

反馈此接口问题 →
kui_window_set_title
有对应声明3.61.7C / Go / Rust

设置窗口标题。 输入字符串采用 UTF-8 和显式字节长度;长度 0 表示 strlen,必填名称、选择器、路径及源码不可为 NULL。

kui_c.h
KUI_C_API KuiStatus kui_window_set_title(KuiWindow* w, const char* title, size_t len);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:252

反馈此接口问题 →
kui_window_should_close
有对应声明3.61.7C / Go / Rust

读取窗口是否应当关闭的状态标记。

kui_c.h
KUI_C_API KuiStatus kui_window_should_close(KuiWindow* w, int* out_should_close);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:267

反馈此接口问题 →
kui_window_show
有对应声明3.61.7C / Go / Rust

显示指定窗口。

kui_c.h
KUI_C_API KuiStatus kui_window_show (KuiWindow* w);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:243

反馈此接口问题 →
kui_window_start_devtools
有对应声明3.61.7C / Go / Rust

在指定端口启动窗口 DevTools,并通过 out_started 报告是否启动。

kui_c.h
KUI_C_API KuiStatus kui_window_start_devtools(KuiWindow* w, uint16_t port, int* out_started);

验证范围

已索引当前源码;未逐项完成运行、组合与平台验收。

sdk/c/include/kui_c.h:273

反馈此接口问题 →
浏览同类接口 →