InputObject Classe

Référence

Définition

Espace de noms:: Microsoft.UI.Input

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Modifier

Classe de base pour tous les objets d’entrée.

[WebHostHidden]
public ref class InputObject

/// [Windows.Foundation.Metadata.ContractVersion(Microsoft.Foundation.WindowsAppSDKContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
/// [Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
[WebHostHidden]
class InputObject

[Windows.Foundation.Metadata.ContractVersion(typeof(Microsoft.Foundation.WindowsAppSDKContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.Agile)]
[Windows.Foundation.Metadata.Threading(Windows.Foundation.Metadata.ThreadingModel.Both)]
public class InputObject

Public Class InputObject

Héritage: Object Platform::Object IInspectable InputObject

Dérivé: Microsoft.UI.Input.InputActivationListener

Microsoft.UI.Input.InputFocusController

Microsoft.UI.Input.InputFocusNavigationHost

Microsoft.UI.Input.InputKeyboardSource

Microsoft.UI.Input.InputLightDismissAction

Plus…

Attributs: ContractVersionAttribute MarshalingBehaviorAttribute ThreadingAttribute

Remarques

Toutes les API d’entrée dans le SDK d'application Windows dérivent de la classe de base InputObject commune.

Modèle de thread InputObject

Un InputObject est accessible uniquement à partir du thread où il a été créé. Tout accès à la propriété ou appel de fonction sur un thread différent retourne RPC_E_WRONG_THREAD (ou le type d’erreur projeté équivalent). La seule exception à cela est lors de l’accès à la propriété InputObject DispatcherQueue . DispatcherQueue vous permet de case activée si le thread actuel a accès et, si ce n’est pas le cas, de mettre en file d’attente le travail vers le thread affiné.

Tous les rappels d’événements sont déclenchés sur le thread DispatcherQueue associé à l’objet InputObject.

L’exemple suivant montre comment déterminer si l’objet InputObject appartient au thread actuel.

bool OnThread(Microsoft.UI.Input.InputObject inputObject)
{
    return inputObject.DispatcherQueue.HasThreadAccess();
}

Comportement en cas de suppression

Lorsqu’un InputObject est supprimé, tous les gestionnaires d’événements associés sont automatiquement désinscrits. Les appels suivants pour annuler l’inscription d’un gestionnaire d’événements réussissent, mais ne sont pas obligatoires.

Tous les appels de fonction ou de propriété suivants, y compris la propriété DispatcherQueue, retournent RO_E_CLOSED (ou l’erreur projetée équivalente).

Notes

La mémoire InputObject reste valide jusqu’à ce que toutes les références aient été libérées, mais toutes les ressources sont libérées lorsqu’elles sont supprimées.

Propriétés

DispatcherQueue

Obtient dispatcherQueue pour l’objet InputObject.

S’applique à

Partager via