UIElement.UseLayoutRounding Propriété

Définition

Espace de noms:

Microsoft.UI.Xaml

Obtient ou définit une valeur qui détermine si le rendu de l’objet et de sa sous-arborescence visuelle doit utiliser un comportement d’arrondi qui aligne le rendu sur des pixels entiers.

public:
 property bool UseLayoutRounding { bool get(); void set(bool value); };

bool UseLayoutRounding();

void UseLayoutRounding(bool value);

public bool UseLayoutRounding { get; set; }

var boolean = uIElement.useLayoutRounding;
uIElement.useLayoutRounding = boolean;

Public Property UseLayoutRounding As Boolean

<uiElement UseLayoutRounding="bool" />

Valeur de propriété

Boolean

bool

true si le rendu et la disposition doivent utiliser l’arrondi de disposition en pixels entiers ; sinon, false. La valeur par défaut est true.

Remarques

Différentes propriétés Windows Runtime de type Double sont utilisées pour spécifier les valeurs ou caractéristiques souhaitées de disposition. Les plus évidentes sont Height et Width , mais il y en a beaucoup d’autres. La valeur par défaut true pour UseLayoutRounding entraîne les opérations de mesure et de disposition pour arrondir les valeurs de sous-pixels potentiels de ces propriétés de disposition à la valeur entière la plus proche, et restituer les objets alignés sur les limites de pixels. Ce comportement est destiné à réduire les artefacts visuels qui peuvent apparaître lorsqu’une valeur de sous-pixel affiche et affecte des pixels de chaque côté de la limite du sous-pixel. L’exemple le plus important d’un tel artefact est lorsque vous envisagez de produire une ligne nette et fine d’une couleur particulière. Si votre mesure de la ligne a donné une valeur de sous-pixel et que le comportement de la disposition n’a pas été arrondi à des pixels entiers, la ligne peut potentiellement apparaître floue et apparaître comme une nuance de couleur plus sombre que prévu.

L’arrondi de disposition affecte l’aliasing ainsi que le positionnement.

Les scénarios possibles pour définir UseLayoutRounding sur false ne sont pas documentés ici. Si vous pensez qu’il peut y avoir un avantage à activer le rendu de sous-pixel pour votre application, testez la définition de UseLayoutRounding sur false, examinez les résultats visuels et assurez-vous que les artefacts de rendu possibles à partir du rendu de sous-pixel ne l’emportent pas sur les avantages perçus. Si vous définissez UseLayoutRounding sur false, il est courant de le faire à la racine de votre page XAML ou de votre arborescence d’objets.

Voir aussi

• Définir des dispositions avec XAML