当前位置:首页 > 技术 > 正文内容

CCSystemBar控件详解 - Android系统栏适配方案

访客 技术 2026年7月10日 1

自Android 4.4版本起,谷歌引入了沉浸式全屏模式,该模式下状态栏和虚拟导航键会自动隐藏,应用得以充分利用整个屏幕空间,为用户带来沉浸式的视觉体验。到了Android 5.0时期,谷歌进一步推出了ColorPalette功能,允许开发者自定义系统区域的颜色,从而实现应用配色与系统风格的协调统一。

在CCSystemBar出现之前,使用Delphi实现上述功能需要编写大量复杂的原生代码,开发者需要处理各种系统版本兼容性问题。如今借助CCSystemBar控件,这些工作变得轻而易举。

首先了解CCSystemBar提供的核心方法:

    procedure TranslucentStatusBar;

    function checkDeviceHasNavigationBar: Boolean;
    function checkNavigationBarShow: Boolean;
    function getStatusBarPixelHeight(): Integer;
    function getStatusBarPointHeight(): Single;
    function getNavigationBarPixelHeight(): Integer;
    function getNavigationBarPointHeight(): Single;

上述方法分别用于检测导航栏是否存在、判断导航栏是否可见、获取状态栏和导航栏的像素高度及Point高度。接下来详细介绍具体应用步骤:

1.将CCSystemBar控件拖放到主窗体上,同时需要在uses中添加CC.VirtualKeyboard单元引用,以确保虚拟键盘相关功能正常工作。

2.在窗体顶部放置一个ToolBar控件用于占据状态栏区域,也可以使用TRectangle等其他可视化组件。然后通过CCSystemBar获取的状态栏高度来设置该控件的上边距:

AToolBar.Padding.Top := Self.CCSystemBar1.getStatusBarPointHeight;

开发者也可以根据实际需求选择其他布局实现方式。

3.底部导航栏的处理方式与顶部类似,需要放置一个ToolBar并将其Align属性设置为alMostBottom:

procedure TMainForm.<strong>AdjustToolBarHeight</strong>(AToolBar: TToolBar);
begin
  if Self.CCSystemBar1.checkNavigationBarShow then
  begin
    AToolBar.Height := Self.CCSystemBar1.getNavigationBarPointHeight;
  end
  else
  begin
    AToolBar.Height := 0;
  end;
end;

这段逻辑的核心思想是:当系统导航栏可见时,将ToolBar高度设置为系统导航栏的高度;否则将高度设为零。

4.为了正确响应系统虚拟键盘的显示与隐藏,需要分别处理Form的OnVirtualKeyboardHidden和OnVirtualKeyboardShown事件:

procedure TMainForm.FormVirtualKeyboardHidden(Sender: TObject;
  KeyboardVisible: Boolean; const Bounds: TRect);
begin
  AdjustToolBarHeight(Self.BottomToolBar);
end;

procedure TMainForm.FormVirtualKeyboardShown(Sender: TObject;
  KeyboardVisible: Boolean; const Bounds: TRect);
begin
  AdjustToolBarHeight(Self.BottomToolBar);
end;

5.在窗体的OnCreate事件中进行初始化操作,设置状态栏和导航栏的初始高度:

procedure TMainForm.FormCreate(Sender: TObject);
begin
  Self.CCSystemBar1.TranslucentStatusBar;
  AdjustStatusBarPadding(Self.TopToolBar);
  AdjustToolBarHeight(Self.BottomToolBar);
end;

6.发布配置是关键步骤:

打开Deployment窗口,按照图中所示操作:移除项目默认的styles.xml和styles-v21.xml文件,替换为ChinaCock提供的对应版本文件。

将启动图片更换为loading.png,并删除系统默认的splash_image_def.xml文件。

完成上述配置后,运行应用程序即可看到效果:

补充说明:

2020年4月1日补充:需要特别留意项目设置中的Include splash image选项必须勾选,如下图所示:

作者曾因忘记勾选此选项,导致应用显示异常,调试许久才找出原因。

相关文章

Linux crontab 详解

1) crontab 是什么cron 是 Linux 的定时任务守护进程;crontab 是用来编辑/查看“按时间周期执行命令”的表(cron table)。常见两类:用户 crontab:每个用户一份(crontab -e 编辑)系统级 crontab / cron.d:可指定执行用户(/etc/crontab、/etc/cron.d/*)2) crontab 时间...

富文本里可以允许的 HTML 属性

一、所有标签默认允许的安全属性(极少)class        (可选)id           (通常建议禁用)title️ 注意:id 容易被滥用做锚点注入,很多系统直接禁用class 允许的话最好只允许固定前缀(如 editor-*)二、a 标签允许属性<a href="" t...

Mac 安装 Node.js 指南

方法一:通过官网安装包(最简单,适合初学者)如果你只是想快速安装并开始使用,这是最直接的方法。访问 Node.js 官网。页面会显示两个版本:LTS (Recommended For Most Users):长期支持版,最稳定。建议选这个。Current:最新特性版,包含最新功能但可能不够稳定。下载 .pkg 安装包并运行。按照安装向导点击“下一步”即可完成。方法二:使用 Homebrew 安装(...

Dom\HTML_NO_DEFAULT_NS 的副作用:自动加闭合标签

在使用Dom\HTMLDocument时,Dom\HTML_NO_DEFAULT_NS 将禁止在解析过程中设置元素的命名空间, 此设置是为了与DOMDocument向后兼容而存在的。当使用它时,已知的一个副作用就是:自动加闭合标签例如 </img> 为什么会这样?当你使用:Dom\HTML_NO_DEFAULT_NS文档会变成 无命名空间模式,此时内部更接近 XML...

Laravel 事件和监听器创建

在 Laravel 中,使用 Artisan 命令创建 Events(事件) 和 Listeners(监听器) 是非常高效的。你可以通过以下几种方式来实现:1. 手动创建单个 Event如果你只想创建一个事件类,可以使用 make:event 命令:Bashphp artisan make:event UserRegistered执行后,文件将生成在 app/Even...

自定义域名解析神器 dnsmasq

什么是 dnsmasq?dnsmasq 是一个轻量级、功能强大的网络服务工具,专为小型和中等规模网络设计。它是一个综合的网络基础设施解决方案[1]。dnsmasq 能做什么?功能说明应用场景DNS 转发与缓存将 DNS 查询转发到上游服务器(ISP、Google DNS 等),并在本地缓存结果加快 DNS 查询速度,减少外部 DNS 流量本地 DNS解析本地网络设备的主机名,无需编辑&n...

发表评论

访客

◎欢迎参与讨论,请在这里发表您的看法和观点。