CoreCursor Classe

Definição

Namespace:

Windows.UI.Core

Define um objeto cursor (ponteiro visual).

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

Herança

Object Platform::Object IInspectable CoreCursor

Atributos

ActivatableAttribute ContractVersionAttribute MarshalingBehaviorAttribute

Requisitos do Windows

Família de dispositivos	Windows 10 (introduzida na 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (introduzida na v1.0)

Exemplos

Este exemplo mostra como definir um cursor de "mão" quando o ponteiro está sobre um botão.

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

Comentários

Para criar uma instância CoreCursor usando um cursor predefinido do Windows, use qualquer um dos tipos de cursor disponíveis na enumeração CoreCursorType diferente de Custom. Nesse caso, a propriedade Id é ignorada.

Para usar um cursor personalizado, use a opção de enumeração CoreCursorType.Custom e especifique a ID do cursor personalizado. Você pode adicionar um arquivo de recurso .res que contém o cursor personalizado ao projeto e incluí-lo no assembly com a opção do compilador /win32res . A ID é a ID do Recurso do Cursor especificada no arquivo .res .

Construtores

CoreCursor(CoreCursorType, UInt32)

Cria uma nova instância CoreCursor do tipo de cursor fornecido.

Propriedades

Id	Obtém a ID do recurso do cursor.
Type	Obtém o tipo do cursor.