接口参考

kui_c.h · C API · 2/3

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

阅读相关开发指南 →

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

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

取得事件目标元素的计数引用,使用后须 release;若目标是文本等非元素节点,返回 NOT_FOUND。 evt 仅在当前回调期间有效,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_get_target (KuiEvent* evt, KuiElement** out);

验证范围

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

sdk/c/include/kui_c.h:437

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

读取当前事件类型名称。 输出为调用者缓冲区中的 UTF-8:可先以 NULL/0 查询长度,再分配 out_len+1;长度不含 NUL。容量不足返回 BUFFER_TOO_SMALL 并报告所需长度;容量大于 0 时仍写入 NUL 结尾的截断结果。 evt 仅在当前回调期间有效,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_get_type (KuiEvent* evt, char* buf, size_t buf_capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:434

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

读取借用事件的运行时类型标签,区分基础、鼠标、滚轮、指针、键盘、焦点、输入和拖放。仅在回调有效期内访问事件。

kui_c.h
KUI_C_API KuiStatus kui_event_get_type_tag(KuiEvent* event, KuiCEventTypeTag* out_tag);

验证范围

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

sdk/c/include/kui_c.h:759

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

读取键盘事件的物理键代码,如 KeyA;非键盘事件返回 KUI_ERR_NOT_SUPPORTED。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。 事件仅在回调内借用,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_key_get_code(KuiEvent* evt, char* buf, size_t buf_capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:461

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

读取键盘事件的语义按键名,如 a、Enter、ArrowUp;非键盘事件返回 KUI_ERR_NOT_SUPPORTED。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。 事件仅在回调内借用,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_key_get_key (KuiEvent* evt, char* buf, size_t buf_capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:460

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

读取键盘事件的 Ctrl、Shift、Alt、Meta 状态;不关心的输出可传 NULL。非键盘事件返回 KUI_ERR_NOT_SUPPORTED。 事件仅在回调内借用,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_key_get_modifiers(KuiEvent* evt, int* out_ctrl, int* out_shift, int* out_alt, int* out_meta);

验证范围

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

sdk/c/include/kui_c.h:463

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

读取鼠标事件的按键枚举值 KuiCMouseButton;非鼠标事件返回 KUI_ERR_NOT_SUPPORTED。事件仅在当前回调中有效,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_mouse_get_button (KuiEvent* evt, int* out_button);

验证范围

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

sdk/c/include/kui_c.h:455

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

读取鼠标事件的视口相对 client 坐标;非鼠标事件返回 NOT_SUPPORTED。 evt 仅在当前回调期间有效,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_mouse_get_client_xy(KuiEvent* evt, float* x, float* y);

验证范围

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

sdk/c/include/kui_c.h:451

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

读取鼠标事件相对目标 padding box 的 offset 坐标;非鼠标事件返回 NOT_SUPPORTED。 evt 仅在当前回调期间有效,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_mouse_get_offset_xy(KuiEvent* evt, float* x, float* y);

验证范围

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

sdk/c/include/kui_c.h:453

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

读取鼠标事件的 page 坐标,包含滚动偏移;非鼠标事件返回 NOT_SUPPORTED。 evt 仅在当前回调期间有效,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_mouse_get_page_xy (KuiEvent* evt, float* x, float* y);

验证范围

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

sdk/c/include/kui_c.h:452

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

在当前事件回调中阻止默认行为。 evt 仅在当前回调期间有效,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_prevent_default (KuiEvent* evt);

验证范围

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

sdk/c/include/kui_c.h:439

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

在当前事件回调中停止后续传播。 evt 仅在当前回调期间有效,不可保存或释放。

kui_c.h
KUI_C_API KuiStatus kui_event_stop_propagation(KuiEvent* evt);

验证范围

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

sdk/c/include/kui_c.h:440

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

读取扩展调用实际返回值的数量,用于按索引访问结果。

kui_c.h
KUI_C_API KuiStatus kui_extension_result_get_count(KuiExtensionResult* result, size_t* out_count);

验证范围

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

sdk/c/include/kui_c.h:887

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

读取扩展调用结果中的错误文本。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。

kui_c.h
KUI_C_API KuiStatus kui_extension_result_get_error(KuiExtensionResult* result, char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:896

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

读取扩展方法调用自身的状态码;它与获取结果接口返回的 KuiStatus 是不同层次。

kui_c.h
KUI_C_API KuiStatus kui_extension_result_get_status(KuiExtensionResult* result, int* out_status);

验证范围

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

sdk/c/include/kui_c.h:885

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

按索引复制扩展字符串结果;索引越界返回 NOT_FOUND,结果不是字符串则返回 NOT_SUPPORTED。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。

kui_c.h
KUI_C_API KuiStatus kui_extension_result_get_string(KuiExtensionResult* result, size_t index, char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:892

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

按索引读取扩展结果的类型和标量字段;越界返回 NOT_FOUND。字符串只报告 string_len,string_value 被置 NULL,正文须用 get_string 复制。

kui_c.h
KUI_C_API KuiStatus kui_extension_result_get_value(KuiExtensionResult* result, size_t index, KuiCExtensionValue* out_value);

验证范围

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

sdk/c/include/kui_c.h:889

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

释放扩展调用结果句柄,仅释放一次;需要的值和错误文本应在释放前读取。

kui_c.h
KUI_C_API KuiStatus kui_extension_result_release(KuiExtensionResult* result);

验证范围

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

sdk/c/include/kui_c.h:884

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

读取已加载动态库的运行时版本,可能与编译时版本宏不同。

kui_c.h
KUI_C_API KuiVersion kui_get_version(void);

验证范围

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

sdk/c/include/kui_c.h:101

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

取消该客户端所有尚未完成的异步请求。

kui_c.h
KUI_C_API KuiStatus kui_http_client_cancel_all(KuiHttpClient* client);

验证范围

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

sdk/c/include/kui_c.h:836

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

创建 HTTP 客户端句柄,用于同步或异步请求;使用后由 kui_http_client_release 释放。

kui_c.h
KUI_C_API KuiStatus kui_http_client_create(KuiHttpClient** out_client);

验证范围

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

sdk/c/include/kui_c.h:824

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

异步请求 URL 并在完成时回调;回调可能运行在工作线程,不能直接修改 DOM。回调取得响应所有权并负责 release;分配失败时响应可为 NULL,回调不得抛异常。

kui_c.h
KUI_C_API KuiStatus kui_http_client_fetch_async(KuiHttpClient* client, const char* url, size_t len, double timeout_seconds, KuiHttpResponseFn fn, void* user_data);

验证范围

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

sdk/c/include/kui_c.h:832

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

同步请求 URL,阻塞至完成或超时;返回的响应句柄须单独 release。KUI_OK 仅说明调用完成,HTTP 状态和网络错误要从响应读取。

kui_c.h
KUI_C_API KuiStatus kui_http_client_fetch_sync(KuiHttpClient* client, const char* url, size_t len, double timeout_seconds, KuiHttpResponse** out_response);

验证范围

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

sdk/c/include/kui_c.h:828

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

释放并销毁 HTTP 客户端句柄;仅释放一次,不可在释放后继续发起请求。

kui_c.h
KUI_C_API KuiStatus kui_http_client_release(KuiHttpClient* client);

验证范围

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

sdk/c/include/kui_c.h:825

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

设置该 HTTP 客户端的 User-Agent 请求标识;输入 UTF-8 指针必须非 NULL,len 为零时按 NUL 结尾读取。

kui_c.h
KUI_C_API KuiStatus kui_http_client_set_user_agent(KuiHttpClient* client, const char* user_agent, size_t len);

验证范围

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

sdk/c/include/kui_c.h:826

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

复制响应正文原始字节,可含 NUL;先查询所需字节数,再分配 need+1 的缓冲,当前桥接还写入结束 NUL,正文长度不含这个结束符。

kui_c.h
KUI_C_API KuiStatus kui_http_response_get_body(KuiHttpResponse* response, uint8_t* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:840

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

读取 HTTP 响应的 Content-Type 字符串。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。

kui_c.h
KUI_C_API KuiStatus kui_http_response_get_content_type(KuiHttpResponse* response, char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:843

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

读取 HTTP 响应的网络错误说明字符串,供调用方判断和显示请求失败原因。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。

kui_c.h
KUI_C_API KuiStatus kui_http_response_get_error(KuiHttpResponse* response, char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:846

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

读取 HTTP 响应状态码;网络传输错误还应另查错误文本。

kui_c.h
KUI_C_API KuiStatus kui_http_response_get_status(KuiHttpResponse* response, int* out_status_code);

验证范围

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

sdk/c/include/kui_c.h:838

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

释放 HTTP 响应句柄;同步请求返回的响应和异步回调获得的响应均由调用方负责释放一次。

kui_c.h
KUI_C_API KuiStatus kui_http_response_release(KuiHttpResponse* response);

验证范围

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

sdk/c/include/kui_c.h:837

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

查询 Lottie 资源是否加载完成,以 0/1 输出;此处 complete 检查 LoadState::Complete,不是动画播完标志。非 Lottie 元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_lottie_get_complete(KuiElement* element, int* out_complete);

验证范围

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

sdk/c/include/kui_c.h:796

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

读取 Lottie 动画自然宽高;可省略一个输出,但不能全部为 NULL。非 Lottie 元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_lottie_get_natural_size(KuiElement* element, float* out_width, float* out_height);

验证范围

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

sdk/c/include/kui_c.h:797

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

在主线程暂停 Lottie 元素动画;非 Lottie 元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_lottie_pause(KuiElement* element);

验证范围

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

sdk/c/include/kui_c.h:795

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

在主线程请求 Lottie 元素播放;非 Lottie 元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_lottie_play(KuiElement* element);

验证范围

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

sdk/c/include/kui_c.h:794

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

在主线程设置 Lottie 元素资源地址;src 必须非 NULL,非 Lottie 元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_lottie_set_src(KuiElement* element, const char* src, size_t len);

验证范围

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

sdk/c/include/kui_c.h:793

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

读取媒体元素当前播放时间,单位为秒;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_get_current_time(KuiElement* element, double* out_seconds);

验证范围

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

sdk/c/include/kui_c.h:782

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

读取媒体资源时长,单位为秒;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_get_duration(KuiElement* element, double* out_seconds);

验证范围

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

sdk/c/include/kui_c.h:783

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

读取媒体元素是否静音,以 0/1 输出;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_get_muted(KuiElement* element, int* out_muted);

验证范围

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

sdk/c/include/kui_c.h:787

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

读取媒体元素网络状态的整数枚举值;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_get_network_state(KuiElement* element, int* out_state);

验证范围

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

sdk/c/include/kui_c.h:790

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

读取媒体元素是否暂停,以 0/1 输出;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_get_paused(KuiElement* element, int* out_paused);

验证范围

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

sdk/c/include/kui_c.h:788

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

读取媒体元素就绪状态的整数枚举值;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_get_ready_state(KuiElement* element, int* out_state);

验证范围

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

sdk/c/include/kui_c.h:789

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

读取媒体元素当前音量;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_get_volume(KuiElement* element, float* out_volume);

验证范围

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

sdk/c/include/kui_c.h:785

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

查询媒体元素的媒体能力是否可用,以 0/1 输出;非媒体元素返回 NOT_SUPPORTED,不等同于资源已播放成功。

kui_c.h
KUI_C_API KuiStatus kui_media_is_available(KuiElement* element, int* out_available);

验证范围

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

sdk/c/include/kui_c.h:791

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

在主线程暂停媒体元素;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_pause(KuiElement* element);

验证范围

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

sdk/c/include/kui_c.h:778

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

在主线程请求媒体元素播放;传入非媒体元素返回 NOT_SUPPORTED,实际播放还依赖媒体后端与资源状态。

kui_c.h
KUI_C_API KuiStatus kui_media_play(KuiElement* element);

验证范围

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

sdk/c/include/kui_c.h:777

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

在主线程设置媒体元素是否显示播放控件;enabled 非零表示开启,非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_set_controls(KuiElement* element, int enabled);

验证范围

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

sdk/c/include/kui_c.h:780

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

在主线程按秒设置媒体元素播放位置;非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_set_current_time(KuiElement* element, double seconds);

验证范围

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

sdk/c/include/kui_c.h:781

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

在主线程设置媒体元素静音状态;muted 非零表示静音,非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_set_muted(KuiElement* element, int muted);

验证范围

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

sdk/c/include/kui_c.h:786

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

在主线程设置媒体元素的资源地址;src 必须非 NULL,非媒体元素返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_media_set_src(KuiElement* element, const char* src, size_t len);

验证范围

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

sdk/c/include/kui_c.h:779

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

在主线程设置媒体元素音量;非媒体元素返回 NOT_SUPPORTED。取值行为由媒体元素实现决定。

kui_c.h
KUI_C_API KuiStatus kui_media_set_volume(KuiElement* element, float volume);

验证范围

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

sdk/c/include/kui_c.h:784

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

按计时器 ID 清除等待中的超时或间隔任务。

kui_c.h
KUI_C_API KuiStatus kui_platform_clear_timer (KuiTimerId id);

验证范围

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

sdk/c/include/kui_c.h:179

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

复制系统剪贴板中的文本到调用方缓冲。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。

kui_c.h
KUI_C_API KuiStatus kui_platform_get_clipboard_text(char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:702

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

按索引读取显示器边界、工作区、缩放比例及是否主屏;名称写入调用方 UTF-8 缓冲。索引不存在返回 NOT_FOUND。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。

kui_c.h
KUI_C_API KuiStatus kui_platform_get_monitor(size_t index, KuiCMonitorInfo* out_monitor, char* name_buf, size_t name_capacity, size_t* out_name_len);

验证范围

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

sdk/c/include/kui_c.h:696

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

读取当前显示器数量,为后续按索引查询显示器信息提供范围。

kui_c.h
KUI_C_API KuiStatus kui_platform_get_monitor_count(size_t* out_count);

验证范围

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

sdk/c/include/kui_c.h:695

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

读取当前操作系统名称,复制到调用方缓冲。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。

kui_c.h
KUI_C_API KuiStatus kui_platform_get_os_name(char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:706

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

读取当前操作系统版本字符串,复制到调用方缓冲。 输出 UTF-8 可先以 NULL/0 查询长度,再分配 need+1;长度不含结束 NUL,缓冲不足返回 BUFFER_TOO_SMALL 并报告完整所需长度。

kui_c.h
KUI_C_API KuiStatus kui_platform_get_os_version(char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:707

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

读取主显示器的边界、工作区、缩放比例及主屏标记。

kui_c.h
KUI_C_API KuiStatus kui_platform_get_primary_monitor(KuiCMonitorInfo* out_monitor);

验证范围

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

sdk/c/include/kui_c.h:190

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

读取主显示器的物理尺寸;宽、高可只取一项,但不能两个输出都为 NULL。

kui_c.h
KUI_C_API KuiStatus kui_platform_get_primary_monitor_physical_size(float* out_width, float* out_height);

验证范围

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

sdk/c/include/kui_c.h:700

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

检查系统剪贴板当前是否含文本,以整数输出结果。

kui_c.h
KUI_C_API KuiStatus kui_platform_has_clipboard_text(int* out_has_text);

验证范围

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

sdk/c/include/kui_c.h:705

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

初始化进程级平台服务;应在创建 GUI 窗口和运行事件循环前调用。

kui_c.h
KUI_C_API KuiStatus kui_platform_init(void);

验证范围

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

sdk/c/include/kui_c.h:153

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

打开文件选择对话框,支持标题、默认路径、过滤器与多选选项。必须一次提供有效输出缓冲,Windows 建议 32768 字节;取消返回 NOT_FOUND,不能先空缓冲探测再打开。

kui_c.h
KUI_C_API KuiStatus kui_platform_open_file_dialog(const KuiCFileDialogOptions* options, char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:721

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

立即处理当前待办事件后返回,用于宿主拥有自己事件循环的嵌入场景。

kui_c.h
KUI_C_API KuiStatus kui_platform_poll_events(void);

验证范围

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

sdk/c/include/kui_c.h:162

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

请求平台事件循环退出,并指定退出码。

kui_c.h
KUI_C_API KuiStatus kui_platform_quit(int exit_code);

验证范围

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

sdk/c/include/kui_c.h:158

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

安排下一次事件循环空闲时执行一次回调;在主线程执行,user_data 不由 KUI 释放。

kui_c.h
KUI_C_API KuiStatus kui_platform_request_idle(KuiTaskFn fn, void* user_data);

验证范围

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

sdk/c/include/kui_c.h:181

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

阻塞运行平台事件循环,直到请求退出,并输出退出码。

kui_c.h
KUI_C_API KuiStatus kui_platform_run(int* out_exit_code);

验证范围

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

sdk/c/include/kui_c.h:157

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

打开保存文件对话框并返回选定路径。必须一次提供有效输出缓冲,Windows 建议 32768 字节;取消返回 NOT_FOUND,输出路径不会自动保存文件内容。

kui_c.h
KUI_C_API KuiStatus kui_platform_save_file_dialog(const KuiCFileDialogOptions* options, char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:724

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

打开带标题的文件夹选择对话框并复制路径。需一次提供有效缓冲,Windows 建议 32768 字节;取消返回 NOT_FOUND。

kui_c.h
KUI_C_API KuiStatus kui_platform_select_folder_dialog(const char* title, size_t title_len, char* buf, size_t capacity, size_t* out_len);

验证范围

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

sdk/c/include/kui_c.h:727

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

将 UTF-8 文本写入系统剪贴板;text 必须非 NULL,len 为零时按 NUL 结尾读取。

kui_c.h
KUI_C_API KuiStatus kui_platform_set_clipboard_text(const char* text, size_t len);

验证范围

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

sdk/c/include/kui_c.h:704

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

启用或禁用 F12 打开 DevTools 的平台行为。

kui_c.h
KUI_C_API KuiStatus kui_platform_set_f12_devtools_enabled(int enabled);

验证范围

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

sdk/c/include/kui_c.h:182

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

按毫秒间隔安排重复回调并返回计时器 ID;须显式清除。回调仅在事件循环活跃时于主线程执行;user_data 由调用者管理,至少活到计时器清除。

kui_c.h
KUI_C_API KuiStatus kui_platform_set_interval(KuiTaskFn fn, void* user_data, uint32_t interval_ms, KuiTimerId* out_id);

验证范围

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

sdk/c/include/kui_c.h:177

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

按毫秒延迟安排一次回调并返回计时器 ID。回调由活跃事件循环在主线程执行;KUI 不释放 user_data,须保证其在等待及回调期间有效。触发后无需清理该一次性计时器。

kui_c.h
KUI_C_API KuiStatus kui_platform_set_timeout (KuiTaskFn fn, void* user_data, uint32_t delay_ms, KuiTimerId* out_id);

验证范围

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

sdk/c/include/kui_c.h:175

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

关闭平台服务;标准流程在事件循环结束并释放句柄后调用。

kui_c.h
KUI_C_API KuiStatus kui_platform_shutdown(void);

验证范围

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

sdk/c/include/kui_c.h:154

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

等待事件到来或超时;timeout_seconds 为负数时无限等待。

kui_c.h
KUI_C_API KuiStatus kui_platform_wait_events(double timeout_seconds);

验证范围

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

sdk/c/include/kui_c.h:164

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

在主线程把文档绑定到脚本引擎,使脚本可操作该文档;文档须在绑定使用期间保持有效,未启用脚本时返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_script_engine_bind_document(KuiScriptEngine* engine, KuiDocument* document);

验证范围

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

sdk/c/include/kui_c.h:806

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

创建 Lua 脚本引擎句柄,使用后由 kui_script_engine_release 释放;构建未启用脚本或无法创建引擎时返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_script_engine_create(KuiScriptEngine** out_engine);

验证范围

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

sdk/c/include/kui_c.h:804

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

执行 Lua 源码,可传来源名,NULL 来源使用 <eval>;脚本执行结果看 out_success,错误写入调用方缓冲。重试会重新执行源码,不能把有副作用代码作为无害的两次查询;脚本未启用返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_script_engine_eval(KuiScriptEngine* engine, const char* code, size_t code_len, const char* source, size_t source_len, int* out_success, char* error_buf, size_t error_capacity, size_t* out_error_len);

验证范围

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

sdk/c/include/kui_c.h:809

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

在主线程执行已绑定文档中的脚本;要求脚本引擎及相应文档绑定有效,未启用脚本时返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_script_engine_execute_scripts(KuiScriptEngine* engine);

验证范围

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

sdk/c/include/kui_c.h:815

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

释放并销毁脚本引擎句柄,不能重复释放;先解除窗口对该引擎的借用并停止后续调用。

kui_c.h
KUI_C_API KuiStatus kui_script_engine_release(KuiScriptEngine* engine);

验证范围

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

sdk/c/include/kui_c.h:805

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

设置脚本错误回调,提供错误文本、来源、行号及 user_data;fn 为 NULL 可清除回调。回调文本是临时借用,需及时复制;未启用脚本返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_script_engine_set_error_handler(KuiScriptEngine* engine, KuiScriptErrorFn fn, void* user_data);

验证范围

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

sdk/c/include/kui_c.h:816

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

在主线程解除脚本引擎的文档绑定;未启用脚本时返回 NOT_SUPPORTED。

kui_c.h
KUI_C_API KuiStatus kui_script_engine_unbind_document(KuiScriptEngine* engine);

验证范围

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

sdk/c/include/kui_c.h:808

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