Visual.IsPixelSnappingEnabled Propriété

Définition

Espace de noms:

Microsoft.UI.Composition

Obtient ou définit une valeur qui indique si le moteur de composition aligne le visuel rendu avec une limite de pixels.

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

bool IsPixelSnappingEnabled();

void IsPixelSnappingEnabled(bool value);

public bool IsPixelSnappingEnabled { get; set; }

var boolean = visual.isPixelSnappingEnabled;
visual.isPixelSnappingEnabled = boolean;

Public Property IsPixelSnappingEnabled As Boolean

Valeur de propriété

Boolean

bool

true si le moteur de composition aligne le visuel rendu avec une limite de pixels ; sinon, false. Par défaut, il s’agit de false.

Exemples

public Visual CreateVisualTree(Compositor compositor)
{
    // Say we have two visuals, one containing an image and one containing text.
    // The image can be resampled and still look fine, but the text looks bad if
    // it doesn't land perfectly on pixel boundaries.
    var root = compositor.CreateContainerVisual();

    var imageVisual = compositor.CreateSpriteVisual();
    ImageLoadingHelper(imageVisual);

    var textVisual = compositor.CreateSpriteVisual();
    TextLoadingHelper(textVisual);

    textVisual.Offset = new Vector3(50, 0, 0);
    textVisual.IsPixelSnappingEnabled = true;

    root.Children.Add(imageVisual);
    root.Children.Add(textVisual);

    return root;
}

Remarques

L’alignement de pixels vous permet de demander au moteur de composition d’ajuster légèrement la position d’une arborescence visuelle au moment du rendu afin que son origine s’aligne parfaitement sur une limite de pixels. Cela sacrifie la précision de position en échange d’artefacts d’échantillonnage réduits pour les textures.