InkPresenter Classe

Definizione

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

Ereditarietà

Object Platform::Object IInspectable InkPresenter

Attributi

ContractVersionAttribute MarshalingBehaviorAttribute

Requisiti Windows

Esempio

Qui viene illustrato come sovrapporre le annotazioni dell'input penna in un'immagine. Per questo esempio, i dati dell'input penna non vengono acquisiti o salvati da un InkPresenter corrispondente.

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

Qui configuriamo l'oggetto InkPresenter in modo da interpretare come tratti input penna i dati di input provenienti sia dalla penna che dal mouse. Impostiamo anche alcuni attributi iniziali per il tratto input penna usati per il rendering dei tratti nel controllo 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);
}

Gli attributi del tratto input penna si possono impostare in modo dinamico, per adattarli alle preferenze dell'utente o ai requisiti dell'app.

Qui permettiamo all'utente di scegliere in un elenco di colori dell'input penna.

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

Gestiamo quindi le modifiche al colore selezionato e aggiorniamo gli attributi del tratto input penna di conseguenza.

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

Commenti

Per le app di Windows universali, ti consigliamo di usare InkPresenter e il controllo InkCanvas anziché InkManager.

Non è possibile creare direttamente un'istanza della classe InkPresenter. Viene restituito come proprietà di un oggetto InkCanvas .

Per impostazione predefinita, l'input input penna standard e modificato viene gestito interamente da InkPresenter ed eseguito il rendering in InkCanvas come tratto input penna o come tratto di cancellazione, in base a InkInputProcessingConfiguration.Mode.

L'input modificato può essere passato all'app per l'elaborazione impostando InkInputProcessingConfiguration.RightDragAction su InkInputRightDragAction.LeaveUnprocessed.

Tutti gli input possono essere passati all'app per l'elaborazione impostando InkInputProcessingConfiguration.Mode su Nessuno.

Lasciando l'input non elaborato da InkPresenter , è possibile supportare un'esperienza input penna personalizzata e funzionalità estese, ad esempio la selezione.

Per il controllo completo dell'input penna e per eseguirne il rendering nel contesto di dispositivo Direct2D dell'app di Windows universale, anziché il controllo InkCanvas predefinito, chiamare ActivateCustomDrying prima di caricare InkCanvas. Questo richiede un oggetto IInkD2DRenderer per gestire l'input penna (vedere l'esempio di input penna complesso).

Cronologia delle versioni

Proprietà

Metodi

Eventi

Si applica a

Vedi anche

• Interazioni tramite penna e stilo
• Introduzione: Supportare l'input penna nell'app UWP
• Esempio di analisi dell'input penna (di base) (C#)
• Esempio di riconoscimento della grafia input penna (C#)
• Salvare e caricare tratti input penna da un file ISF (Ink Serialized Format)
• Salvare e caricare tratti input penna dagli Appunti
• Esempio di orientamento e posizione della barra degli strumenti input penna (di base)
• Esempio di orientamento e posizione della barra degli strumenti input penna (dinamico)
• Esempio di app Coloring Book
• Esempio FamilyNotes
• Esempio di input penna (JavaScript)
• Esempio di input penna semplice (C#/C++)
• Esempio di input penna complesso (C++)
• Esempio di analisi dell'input penna