Share via

WindowManager.PropertyActivityEmbeddingAllowSystemOverride Field

  • Reference

Definition

Namespace:
Android.Views
Assembly:
Mono.Android.dll

Caution

Use 'Android.Views.IWindowManager.PropertyActivityEmbeddingAllowSystemOverride'. This class will be removed in a future release.

Application-level android.content.pm.PackageManager.Property PackageManager.Property tag that specifies whether OEMs are permitted to provide activity embedding split-rule configurations on behalf of the app.

[Android.Runtime.Register("PROPERTY_ACTIVITY_EMBEDDING_ALLOW_SYSTEM_OVERRIDE", ApiSince=34)]
[System.Obsolete("Use 'Android.Views.IWindowManager.PropertyActivityEmbeddingAllowSystemOverride'. This class will be removed in a future release.")]
public const string PropertyActivityEmbeddingAllowSystemOverride;
[<Android.Runtime.Register("PROPERTY_ACTIVITY_EMBEDDING_ALLOW_SYSTEM_OVERRIDE", ApiSince=34)>]
[<System.Obsolete("Use 'Android.Views.IWindowManager.PropertyActivityEmbeddingAllowSystemOverride'. This class will be removed in a future release.")>]
val mutable PropertyActivityEmbeddingAllowSystemOverride : string

Field Value

String
Attributes
RegisterAttribute ObsoleteAttribute

Remarks

Application-level android.content.pm.PackageManager.Property PackageManager.Property tag that specifies whether OEMs are permitted to provide activity embedding split-rule configurations on behalf of the app.

If true, the system is permitted to override the app's windowing behavior and implement activity embedding split rules, such as displaying activities side by side. A system override informs the app that the activity embedding APIs are disabled so the app will not provide its own activity embedding rules, which would conflict with the system's rules.

If false, the system is not permitted to override the windowing behavior of the app. Set the property to false if the app provides its own activity embedding split rules, or if you want to prevent the system override for any other reason.

The default value is false.

<p class="note"><b>Note:</b> Refusal to permit the system override is not enforceable. OEMs can override the app's activity embedding implementation whether or not this property is specified and set to false. The property is, in effect, a hint to OEMs.

OEMs can implement activity embedding on any API level. The best practice for apps is to always explicitly set this property in the app manifest file regardless of targeted API level rather than rely on the default value.

<b>Syntax:</b>

&lt;application&gt;
              &lt;property
                android:name="android.window.PROPERTY_ACTIVITY_EMBEDDING_ALLOW_SYSTEM_OVERRIDE"
                android:value="true|false"/&gt;
            &lt;/application&gt;

Java documentation for android.view.WindowManager.PROPERTY_ACTIVITY_EMBEDDING_ALLOW_SYSTEM_OVERRIDE.

Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.

Applies to