Configuration.ScreenWidthDp Propriété

[Android.Runtime.Register("screenWidthDp")]
public int ScreenWidthDp { get; set; }

[<Android.Runtime.Register("screenWidthDp")>]
member this.ScreenWidthDp : int with get, set

Valeur de propriété

Largeur d’espace d’écran disponible en pixels indépendants de la densité ou 0 lorsqu’aucune largeur n’est spécifiée.

Attributs

RegisterAttribute

Remarques

Largeur de l’espace d’écran disponible dans les unités dp.

« remarque »><b>Remarque :</b> Si l’application cible <c>android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM</c> ou après, la mesure de largeur reflète la taille de la fenêtre sans exclure les insets. Sinon, la mesure exclut les ensembles de fenêtres même lorsque l’application est affichée en périphérie à l’aide <de c>android.view.Window#setDecorFitsSystemWindows(boolean) Window#setDecorFitsSystemWindows(boolean)</c>.</aside>

Utilisez <c>android.view.WindowMetrics#getBounds()</c> pour toujours obtenir la zone d’affichage horizontale disponible pour une application ou une activité incorporée, y compris la zone occupée par les ensembles de fenêtres. Une version de l’API est également disponible pour une utilisation sur des plateformes plus anciennes via <c>androidx.window.layout.WindowMetrics</c>.

Correspond au qualificateur de ressource de largeur disponible . La valeur par défaut est #SCREEN_WIDTH_DP_UNDEFINED si aucune largeur n’est spécifiée.

En mode multi-fenêtre, correspond à la largeur de la zone d’affichage disponible de la fenêtre d’application, et non à la zone d’affichage disponible de l’écran de l’appareil (par exemple, lorsque les applications sont affichées côte à côte en mode split-screen en orientation paysage).

Pour les activités incorporées, correspond à la largeur des activités individuelles, et non à la largeur de la fenêtre de l’application ou de l’écran de l’appareil.

Dans les scénarios à plusieurs écrans, la mesure de largeur peut s’étendre sur les écrans. Par exemple, si l’application couvre les deux écrans d’un appareil double écran (avec les écrans côte à côte), screenWidthDp représente la largeur des deux écrans à l’exclusion de la zone occupée par les ensembles de fenêtres. Lorsque l’application est limitée à un seul écran dans un environnement à plusieurs écrans, screenWidthDp est la largeur de l’écran sur lequel l’application s’affiche à l’exclusion des ensembles de fenêtres.

Si l’application cible android.os.Build.VERSION_CODES#VANILLA_ICE_CREAM ou après, elle est la même que android.view.WindowMetrics, mais est exprimée arrondie à la dp la plus proche plutôt qu’à px.

Dans le cas contraire, diffère de l’inclusion d’ensembles android.view.WindowMetrics de fenêtres dans la mesure de largeur et en exprimant la mesure en dp plutôt que px. Permet screenWidthDp d’obtenir la largeur de la zone d’affichage disponible pour une application ou une activité incorporée à l’exclusion de la zone occupée par les ensembles de fenêtres.

Java documentation pour android.content.res.Configuration.screenWidthDp.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.