已设置windowActionModeOverlay，Contextual Action Bar仍不覆盖AndroidX Toolbar

1. 确认主题配置的正确性 #

• 确保应用的主题是NoActionBar变体（如Theme.MaterialComponents.DayNight.NoActionBar或Theme.AppCompat.Light.NoActionBar），避免系统默认ActionBar与自定义Toolbar共存。
• 在主题中同时添加以下两个属性（兼容旧版和新版Android）：

  <item name="windowActionModeOverlay">true</item>
  <item name="android:windowActionModeOverlay">true</item>
  

2. 修正Toolbar的设置 #

• 调用setSupportActionBar(toolbar)将自定义Toolbar设置为Activity的ActionBar，确保布局中的Toolbar没有多余的margin/padding或被错误的ViewGroup包裹。
• 若使用AppBarLayout，不要设置scrollFlags="scroll|enterAlways"等滚动属性（除非你需要滚动效果），防止Toolbar位置偏移导致CAB无法覆盖。

3. 使用AndroidX兼容的ActionMode启动方式 #

• 放弃AbsListView.MultiChoiceModeListener，改用ActionMode.Callback接口，调用startSupportActionMode(callback)启动上下文操作栏（而非startActionMode），确保与AndroidX Toolbar兼容。
• 示例代码：

  private ActionMode mActionMode;
  private ActionMode.Callback mActionModeCallback = new ActionMode.Callback() {
      @Override
      public boolean onCreateActionMode(ActionMode mode, Menu menu) {
          mode.getMenuInflater().inflate(R.menu.context_menu, menu);
          return true;
      }
  
      @Override
      public boolean onPrepareActionMode(ActionMode mode, Menu menu) {
          return false;
      }
  
      @Override
      public boolean onActionItemClicked(ActionMode mode, MenuItem item) {
          // 处理操作逻辑
          mode.finish();
          return true;
      }
  
      @Override
      public void onDestroyActionMode(ActionMode mode) {
          mActionMode = null;
          // 重置列表选中状态
          listView.clearChoices();
      }
  };
  
  // ListView长按事件
  listView.setOnItemLongClickListener((parent, view, position, id) -> {
      if (mActionMode == null) {
          mActionMode = startSupportActionMode(mActionModeCallback);
      }
      listView.setItemChecked(position, true);
      return true;
  });
  

4. 自定义ActionMode样式强制覆盖 #

• 若主题设置仍未生效，添加自定义ActionMode样式，强制其背景和层级覆盖Toolbar：

  <style name="Theme.MyApp" parent="Theme.MaterialComponents.DayNight.NoActionBar">
      <!-- 其他主题属性 -->
      <item name="actionModeStyle">@style/CustomActionModeStyle</item>
  </style>
  
  <style name="CustomActionModeStyle" parent="Widget.MaterialComponents.ActionMode">
      <item name="background">?attr/colorPrimary</item> <!-- 和Toolbar背景一致，视觉上更统一 -->
      <item name="android:background">?attr/colorPrimary</item>
      <item name="windowActionModeOverlay">true</item>
      <item name="android:windowActionModeOverlay">true</item>
  </style>
  

5. 检查布局层级 #

• 确保ListView在布局中位于Toolbar下方，没有被其他ViewGroup（如CoordinatorLayout的其他子View）遮挡，根布局尽量使用简单的LinearLayout或ConstraintLayout避免复杂层级干扰。

内容的提问来源于stack exchange，提问作者Calvin Godfrey