Visual.IsPixelSnappingEnabled Proprietà

Definizione

Spazio dei nomi:

Microsoft.UI.Composition

Ottiene o imposta un valore che indica se il motore di composizione allinea l'oggetto visivo sottoposto a rendering con un limite di pixel.

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

Valore della proprietà

Boolean

bool

true se il motore di composizione allinea l'oggetto visivo di cui è stato eseguito il rendering con un limite di pixel; in caso contrario, false. Il valore predefinito è false.

Esempio

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

Commenti

Lo snapping pixel consente di richiedere al motore di composizione di regolare la posizione di un albero visivo leggermente al momento del rendering in modo che l'origine si allinea perfettamente con un limite di pixel. Questo sacrifica l'accuratezza posizionale in cambio di artefatti di campionamento ridotti per trame.