CoreCursor Klasse

Definition

Namespace:

Windows.UI.Core

Definiert ein Cursorobjekt (visueller Zeiger).

public ref class CoreCursor sealed

/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Activatable(Windows.UI.Core.ICoreCursorFactory, 65536, "Windows.Foundation.UniversalApiContract")]
class CoreCursor final

[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Activatable(typeof(Windows.UI.Core.ICoreCursorFactory), 65536, "Windows.Foundation.UniversalApiContract")]
public sealed class CoreCursor

Public NotInheritable Class CoreCursor

Vererbung

Object Platform::Object IInspectable CoreCursor

Attribute

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Beispiele

In diesem Beispiel wird gezeigt, wie sie einen Handcursor festlegen, wenn der Zeiger über einer Schaltfläche liegt.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <Button Content="Button 1"
            PointerEntered="Button_PointerEntered"
            PointerExited="Button_PointerExited"/>
</Grid>

public sealed partial class MainPage : Page
{
    CoreCursor buttonCursor = null;
    CoreCursor cursorBeforePointerEntered = null;

    public MainPage()
    {
        this.InitializeComponent();
        buttonCursor = new CoreCursor(CoreCursorType.Hand, 0);
    }

    private void Button_PointerEntered(object sender, PointerRoutedEventArgs e)
    {
        // Cache the cursor set before pointer enter on button.
        cursorBeforePointerEntered = Window.Current.CoreWindow.PointerCursor;
        // Set button cursor.
        Window.Current.CoreWindow.PointerCursor = buttonCursor;
    }

    private void Button_PointerExited(object sender, PointerRoutedEventArgs e)
    {
        // Change the cursor back.
        Window.Current.CoreWindow.PointerCursor = cursorBeforePointerEntered;
    }
}

Hinweise

Um einen CoreCursor-instance mit einem vordefinierten Windows-Cursor zu erstellen, verwenden Sie einen der in der CoreCursorType-Enumeration verfügbaren Cursortypen außer Custom. In diesem Fall wird die Id-Eigenschaft ignoriert.

Um einen benutzerdefinierten Cursor zu verwenden, verwenden Sie die Enumerationsoption CoreCursorType.Custom , und geben Sie die ID des benutzerdefinierten Cursors an. Sie können ihrem Projekt eine RES-Ressourcendatei hinzufügen, die den benutzerdefinierten Cursor enthält, und sie mit der Compileroption /win32res in Ihre Assembly einschließen. Die ID ist die in der RES-Datei angegebene Cursorressourcen-ID.

Konstruktoren

CoreCursor(CoreCursorType, UInt32)

Erstellt eine neue CoreCursor-instance des angegebenen Cursortyps.

Eigenschaften

Id	Ruft die Ressourcen-ID des Cursors ab.
Type	Ruft den Typ des Cursors ab.