InkPresenter Classe

Définition

public ref class InkPresenter sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
class InkPresenter final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
public sealed class InkPresenter

Public NotInheritable Class InkPresenter

Héritage

Object Platform::Object IInspectable InkPresenter

Attributs

ContractVersionAttribute MarshalingBehaviorAttribute

Configuration requise pour Windows

Exemples

Ici, nous montrons comment superposer des annotations manuscrites sur une image. Pour cet exemple, les données manuscrites ne sont pas capturées ou enregistrées par un InkPresenter correspondant.

<ScrollViewer>
  <Grid>
    <Image Source="<path>"></Image>
    <InkCanvas x:Name="inkCanvas"></InkCanvas>
  </Grid>
</ScrollView

Ici, l’élément InkPresenter est configuré pour interpréter les données d’entrée de stylet et de souris sous forme de traits d’encre. Nous définissons également des attributs de trait d’encre initiaux utilisés pour restituer les traits dans l’élément InkCanvas.

public MainPage()
{
    this.InitializeComponent();

    // Set supported inking device types.
    inkCanvas.InkPresenter.InputDeviceTypes = 
        Windows.UI.Core.CoreInputDeviceTypes.Mouse | 
        Windows.UI.Core.CoreInputDeviceTypes.Pen;

    // Set initial ink stroke attributes.
    InkDrawingAttributes drawingAttributes = new InkDrawingAttributes();
    drawingAttributes.Color = Windows.UI.Colors.Black;
    drawingAttributes.IgnorePressure = false;
    drawingAttributes.FitToCurve = true;
    inkCanvas.InkPresenter.UpdateDefaultDrawingAttributes(drawingAttributes);
}

Les attributs de traits d’encre peuvent être définis de manière dynamique pour s’adapter aux préférences de l’utilisateur ou aux exigences de l’application.

Ici, nous laissons un utilisateur choisir parmi une liste de couleurs d’encre.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Grid.RowDefinitions>
        <RowDefinition Height="Auto"/>
        <RowDefinition Height="*"/>
    </Grid.RowDefinitions>
    <StackPanel x:Name="HeaderPanel" Orientation="Horizontal" Grid.Row="0">
        <TextBlock x:Name="Header" 
                   Text="Basic ink customization sample" 
                   VerticalAlignment="Center"
                   Style="{ThemeResource HeaderTextBlockStyle}" 
                   Margin="10,0,0,0" />
        <TextBlock Text="Color:"
                   Style="{StaticResource SubheaderTextBlockStyle}"
                   VerticalAlignment="Center"
                   Margin="50,0,10,0"/>
        <ComboBox x:Name="PenColor"
                  VerticalAlignment="Center"
                  SelectedIndex="0"
                  SelectionChanged="OnPenColorChanged">
            <ComboBoxItem Content="Black"/>
            <ComboBoxItem Content="Red"/>
        </ComboBox>
    </StackPanel>
    <Grid Grid.Row="1">
        <Image Source="Assets\StoreLogo.png" />
        <InkCanvas x:Name="inkCanvas" />
    </Grid>
</Grid>

Nous traitons ensuite les modifications de manière à tenir compte de la couleur sélectionnée et actualisons les attributs de traits d’encre en conséquence.

// Update ink stroke color for new strokes.
private void OnPenColorChanged(object sender, SelectionChangedEventArgs e)
{
    if (inkCanvas != null)
    {
        InkDrawingAttributes drawingAttributes = 
            inkCanvas.InkPresenter.CopyDefaultDrawingAttributes();

        string value = ((ComboBoxItem)PenColor.SelectedItem).Content.ToString();

        switch (value)
        {
            case "Black":
                drawingAttributes.Color = Windows.UI.Colors.Black;
                break;
            case "Red":
                drawingAttributes.Color = Windows.UI.Colors.Red;
                break;
            default:
                drawingAttributes.Color = Windows.UI.Colors.Black;
                break;
        };

        inkCanvas.InkPresenter.UpdateDefaultDrawingAttributes(drawingAttributes);
    }
}

Remarques

Pour les applications Windows universelles, nous vous recommandons d’utiliser InkPresenter et le contrôle InkCanvas au lieu d’InkManager.

La classe InkPresenter ne peut pas être instanciée directement. Elle est retournée en tant que propriété d’un objet InkCanvas .

Par défaut, l’entrée manuscrite standard et modifiée est entièrement gérée par InkPresenter et rendue dans InkCanvas sous la forme d’un trait d’encre ou d’un trait d’effacement, en fonction de InkInputProcessingConfiguration.Mode.

L’entrée modifiée peut être transmise à votre application pour traitement en définissant InkInputProcessingConfiguration.RightDragAction sur InkInputRightDragAction.LeaveUnprocessed.

Toutes les entrées peuvent être transmises à votre application pour traitement en définissant InkInputProcessingConfiguration.Mode sur None.

Le fait de laisser l’entrée non traitées par InkPresenter vous permet de prendre en charge une expérience d’entrée manuscrite personnalisée et des fonctionnalités étendues telles que la sélection.

Pour un contrôle complet de l’entrée manuscrite et pour la restituer dans le contexte d’appareil Direct2D de votre application Windows universelle, au lieu du contrôle InkCanvas par défaut, appelez ActivateCustomDrying avant de charger InkCanvas. Cela nécessite un objet IInkD2DRenderer pour gérer l’entrée manuscrite (voir l’exemple d’entrée manuscrite complexe).

Historique des versions

Propriétés

Méthodes

Événements

S’applique à

Voir aussi

• Interactions avec le stylo et le stylet
• Prise en main : Prise en charge de l’entrée manuscrite dans votre application UWP
• Exemple d’analyse d’entrée manuscrite (de base) (C#)
• Exemple de reconnaissance de l’écriture manuscrite manuscrite (C#)
• Enregistrer et charger des traits d’encre à partir d’un fichier ISF (Ink Serialized Format)
• Enregistrer et charger des traits d’encre à partir du Presse-papiers
• Exemple d’emplacement et d’orientation de la barre d’outils d’encre (de base)
• Exemple d’emplacement et d’orientation de la barre d’outils Ink (dynamique)
• Exemple de livre de coloriage
• Exemple de notes de famille
• Exemple d’entrée manuscrite (JavaScript)
• Exemple d’entrée manuscrite simple (C#/C++)
• Exemple d’entrée manuscrite complexe (C++)
• Exemple d’analyse de l’entrée manuscrite