Control.RequiresPointer Proprietà
Definizione
Importante
Alcune informazioni sono relative alla release non definitiva del prodotto, che potrebbe subire modifiche significative prima della release definitiva. Microsoft non riconosce alcuna garanzia, espressa o implicita, in merito alle informazioni qui fornite.
Ottiene o imposta un valore che indica se un elemento dell'interfaccia utente supporta la modalità mouse, che emula le esperienze di interazione del puntatore con dispositivi di input non puntatore, ad esempio un game pad o un telecomando.
public:
property RequiresPointer RequiresPointer { RequiresPointer get(); void set(RequiresPointer value); };RequiresPointer RequiresPointer();
void RequiresPointer(RequiresPointer value);public RequiresPointer RequiresPointer { get; set; }var requiresPointer = control.requiresPointer;
control.requiresPointer = requiresPointer;Public Property RequiresPointer As RequiresPointer<control RequiresPointer="requiresPointerMemberName"/>
Valore della proprietà
Modalità di emulazione del puntatore. Il valore predefinito è Never.
Requisiti Windows
| Famiglia di dispositivi |
Windows 10 Anniversary Edition (è stato introdotto in 10.0.14393.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (è stato introdotto in v3.0)
|
Commenti
Per i dispositivi di input non puntatore, lo stato attivo viene spostato tra i controlli tramite diversi metodi, ad esempio tabulazione e tasti di direzione su una tastiera, il pad direzionale (D-pad) su un telecomando o le levette del pollice su un controller di gioco. Per alcune esperienze utente, ad esempio mappe e superfici di disegno, non è possibile o pratico usare lo spostamento con stato attivo XY. RequiresPointer consente a un'app di offrire un'esperienza di interazione più simile a un puntatore tramite un cursore che può essere spostato liberamente usando i dispositivi di input del gioco.
RequiresPointer è supportato solo nella famiglia di dispositivi Xbox e solo quando si usa un game pad o un telecomando. La proprietà viene ignorata in caso contrario.
RequiresPointerMode imposta la modalità mouse a livello di applicazione.
Per altre info, vedi la sezione Modalità mouse di Progettazione per Xbox e TV.
Compatibilità tra versioni
La proprietà RequiresPointer non è disponibile prima di Windows 10 versione 1607. Se l'impostazione "versione minima della piattaforma" dell'app in Microsoft Visual Studio è inferiore alla "versione introdotta" visualizzata nel blocco Requisiti più avanti in questa pagina, è necessario progettare e testare l'app per tenere conto di questo aspetto. Per altre info, vedi Codice adattivo per la versione.
Per evitare eccezioni quando l'app viene eseguita nelle versioni precedenti di Windows 10, non impostare questa proprietà in XAML o usarla senza eseguire un controllo di runtime. Questo esempio mostra come usare la classe ApiInformation per verificare la presenza di questa proprietà prima di impostarla.
if (ApiInformation.IsPropertyPresent("Windows.UI.Xaml.Controls.Control", "RequiresPointer"))
{
mapControl1.RequiresPointer = RequiresPointer.WhenEngaged;
}