Visual.IsPixelSnappingEnabled Propiedad

Definición

Espacio de nombres:

Microsoft.UI.Composition

Obtiene o establece un valor que indica si el motor de composición alinea el objeto visual representado con un límite de píxel.

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

Valor de propiedad

Boolean

bool

true si el motor de composición alinea el objeto visual representado con un límite de píxeles; de lo contrario, false. El valor predeterminado es false.

Ejemplos

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;
}

Comentarios

El ajuste de píxeles le permite solicitar que el motor de composición ajuste la posición de un árbol visual ligeramente en tiempo de representación para que su origen se alinee perfectamente con un límite de píxeles. Esto sacrifica la precisión posicional a cambio de artefactos de muestreo reducidos para texturas.