InkPresenter Klasse

Definition

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

Vererbung

Object Platform::Object IInspectable InkPresenter

Attribute

ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Beispiele

Hier zeigen wir, wie Freihandanmerkungen in einem Bild überlagert werden. In diesem Beispiel werden Freihanddaten nicht von einem entsprechenden InkPresenter erfasst oder gespeichert.

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

Hier konfigurieren wir InkPresenter, damit Eingabedaten von Stift und Maus als letzte Striche interpretiert werden. Wir legen auch einige anfängliche Freihandstrichattribute fest, die zum Rendern von Strichen in InkCanvas verwendet werden.

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

Attribute für letzte Striche können dynamisch entsprechend den Benutzereinstellungen oder App-Anforderungen festgelegt werden.

Hier kann der Benutzer aus einer Liste von Freihandfarben auswählen.

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

Anschließend behandeln wir Änderungen an der ausgewählten Farbe und aktualisieren die Attribute für letzte Striche entsprechend.

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

Hinweise

Für universelle Windows-Apps wird empfohlen, InkPresenter und das InkCanvas-Steuerelement anstelle von InkManager zu verwenden.

Die InkPresenter-Klasse kann nicht direkt instanziiert werden. Sie wird als Eigenschaft eines InkCanvas-Objekts zurückgegeben.

Standardmäßig werden sowohl standard- als auch geänderte Freihandeingaben vollständig von InkPresenter verwaltet und in InkCanvas entweder als Freihandstrich oder als Löschstrich gerendert, basierend auf InkInputProcessingConfiguration.Mode.

Geänderte Eingaben können zur Verarbeitung an Ihre App übergeben werden, indem InkInputProcessingConfiguration.RightDragAction auf InkInputRightDragAction.LeaveUnprocessed festgelegt wird.

Alle Eingaben können zur Verarbeitung an Ihre App übergeben werden, indem InkInputProcessingConfiguration.Mode auf None festgelegt wird.

Wenn Eingaben von InkPresenter nicht verarbeitet werden, können Sie eine angepasste Freihandoberfläche und erweiterte Funktionen wie die Auswahl unterstützen.

Um die Freihandeingabe vollständig zu steuern und sie im Direct2D-Gerätekontext Ihrer universellen Windows-App zu rendern, rufen Sie anstelle des InkCanvas-StandardsteuerelementsActivateCustomDrying auf, bevor Sie die InkCanvas laden. Dazu ist ein IInkD2DRenderer-Objekt erforderlich, um die Freihandeingabe zu verwalten (siehe Beispiel für komplexe Freihandeingaben).

Versionsverlauf

Eigenschaften

Methoden

Ereignisse

Gilt für:

Weitere Informationen

• Zeichen- und Eingabestiftinteraktionen
• Erste Schritte: Freihandunterstützung in Ihrer UWP-App
• Freihandanalysebeispiel (Basic) (C#)
• Beispiel für die Freihandschreiberkennung (C#)
• Speichern und Laden von Freihandstrichen aus einer ISF-Datei (Ink Serialized Format)
• Speichern und Laden von Freihandstrichen aus der Zwischenablage
• Beispiel für Position und Ausrichtung der Freihandsymbolleiste (Basic)
• Freihandsymbolleistenposition und Orientierungsbeispiel (dynamisch)
• Malbuchbeispiel
• Familiennotizbeispiel
• Freihandbeispiel (JavaScript)
• Beispiel für einfache Freihandeingaben (C#/C++)
• Beispiel für komplexe Freihandeingaben (C++)
• Freihandanalysebeispiel