PointerDevice Classe
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.
Prend en charge la possibilité d’identifier les appareils pointeurs connectés et de déterminer leurs capacités.
public ref class PointerDevice sealed
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
class PointerDevice final
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.MarshalingBehavior(Windows.Foundation.Metadata.MarshalingType.None)]
public sealed class PointerDevice
Public NotInheritable Class PointerDevice
- Héritage
- Attributs
Famille d’appareils |
Windows 10 (introduit dans 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (introduit dans v1.0)
|
Le code suivant montre comment utiliser PointerDevice.
/// <summary>
/// Invoked when this page is about to be displayed in a Frame.
/// </summary>
/// <param name="e">Event data that describes how this page was reached. The Parameter
/// property is typically used to configure the page.</param>
protected override void OnNavigatedTo(NavigationEventArgs e)
{
string Buffer;
Buffer = "List of all pointer devices: \n\n";
var PointerDeviceList = Windows.Devices.Input.PointerDevice.GetPointerDevices();
int displayIndex = 1;
foreach (Windows.Devices.Input.PointerDevice PointerDevice in PointerDeviceList)
{
Buffer += string.Format("Pointer device " + displayIndex + ":\n");
Buffer += string.Format("This pointer device type is " +
PointerType(PointerDevice) + "\n");
Buffer += string.Format("This pointer device is " +
(PointerDevice.IsIntegrated ? "not " : "") + "external\n");
Buffer += string.Format("This pointer device has a maximum of " +
PointerDevice.MaxContacts + " contacts\n");
Buffer += string.Format("The physical device rect is " +
PointerDevice.PhysicalDeviceRect.X.ToString() + ", " +
PointerDevice.PhysicalDeviceRect.Y.ToString() + ", " +
PointerDevice.PhysicalDeviceRect.Width.ToString() + ", " +
PointerDevice.PhysicalDeviceRect.Height.ToString() + "\n");
Buffer += string.Format("The screen rect is " +
PointerDevice.ScreenRect.X.ToString() + ", " +
PointerDevice.ScreenRect.Y.ToString() + ", " +
PointerDevice.ScreenRect.Width.ToString() + ", " +
PointerDevice.ScreenRect.Height.ToString() + "\n\n");
}
PointerOutputTextBlock.Text = Buffer;
}
#include <sstream>
#include <winrt/Windows.Devices.Input.h>
#include <winrt/Windows.Foundation.Collections.h>
#include <winrt/Windows.UI.Xaml.Controls.h>
using namespace winrt;
using namespace Windows::Devices::Input;
using namespace Windows::UI::Xaml::Controls;
...
void PointerGetSettings_Click(Windows::Foundation::IInspectable const& sender, Windows::UI::Xaml::RoutedEventArgs const& args)
{
auto b{ sender.try_as<Button>() };
if (b)
{
Windows::Foundation::Collections::IVectorView<PointerDevice> pointerDeviceList{ PointerDevice::GetPointerDevices() };
std::wostringstream buffer;
for (uint32_t i = 0; i < pointerDeviceList.Size(); i++)
{
winrt::hstring displayIndex{ winrt::to_hstring(i + 1) };
buffer << L"Pointer device " << displayIndex.c_str() << std::endl;
buffer << L"This pointer device type is ";
switch (pointerDeviceList.GetAt(i).PointerDeviceType())
{
case PointerDeviceType::Mouse:
buffer << L"Mouse" << std::endl;
break;
case PointerDeviceType::Pen:
buffer << L"Pen" << std::endl;
break;
case PointerDeviceType::Touch:
buffer << L"Touch" << std::endl;
break;
default:
buffer << L"unknown" << std::endl;
}
buffer << L"This pointer device is " << (pointerDeviceList.GetAt(i).IsIntegrated() ? L"not " : L"") << L"external" << std::endl;
buffer << L"This pointer device has a maximum of " << pointerDeviceList.GetAt(i).MaxContacts() << L" contacts" << std::endl;
buffer << L"The physical device rect is " <<
pointerDeviceList.GetAt(i).PhysicalDeviceRect().X << L", " <<
pointerDeviceList.GetAt(i).PhysicalDeviceRect().Y << L", " <<
pointerDeviceList.GetAt(i).PhysicalDeviceRect().Width << L", " <<
pointerDeviceList.GetAt(i).PhysicalDeviceRect().Height << std::endl;
buffer << L"The screen rect is " <<
pointerDeviceList.GetAt(i).ScreenRect().X << L", " <<
pointerDeviceList.GetAt(i).ScreenRect().Y << L", " <<
pointerDeviceList.GetAt(i).ScreenRect().Width << L", " <<
pointerDeviceList.GetAt(i).ScreenRect().Height << std::endl << std::endl;
}
PointerOutputTextBlock().Text(buffer.str());
}
}
void SDKSample::DeviceCaps::Pointer::PointerGetSettings_Click(Platform::Object^ sender, Windows::UI::Xaml::RoutedEventArgs^ e)
{
Button^ b = safe_cast<Button^>(sender);
if (b != nullptr)
{
Windows::Foundation::Collections::IVectorView<PointerDevice^>^ PointerDeviceList = PointerDevice::GetPointerDevices();
Platform::String^ Buffer;
for (unsigned i = 0; i < PointerDeviceList->Size; i++) {
Platform::String^ displayIndex = (i + 1).ToString();
Buffer += "Pointer device " + displayIndex + ":\n";
Buffer += "This pointer device type is " + PointerType(PointerDeviceList->GetAt(i)) + "\n";
Buffer += "This pointer device is " + (PointerDeviceList->GetAt(i)->IsIntegrated ? "not " : "") + "external\n";
Buffer += "This pointer device has a maximum of " + PointerDeviceList->GetAt(i)->MaxContacts.ToString() + " contacts\n";
Buffer += "The physical device rect is " +
PointerDeviceList->GetAt(i)->PhysicalDeviceRect.X.ToString() + ", " +
PointerDeviceList->GetAt(i)->PhysicalDeviceRect.Y.ToString() + ", " +
PointerDeviceList->GetAt(i)->PhysicalDeviceRect.Width.ToString() + ", " +
PointerDeviceList->GetAt(i)->PhysicalDeviceRect.Height.ToString() + "\n";
Buffer += "The screen rect is " +
PointerDeviceList->GetAt(i)->ScreenRect.X.ToString() + ", " +
PointerDeviceList->GetAt(i)->ScreenRect.Y.ToString() + ", " +
PointerDeviceList->GetAt(i)->ScreenRect.Width.ToString() + ", " +
PointerDeviceList->GetAt(i)->ScreenRect.Height.ToString() + "\n\n";
}
PointerOutputTextBlock->Text = Buffer;
}
}
Les valeurs retournées par les propriétés décrites ici sont basées sur le nombre total d’appareils pointeurs connectés : les propriétés booléennes retournent true si un appareil prend en charge une fonctionnalité spécifique et les propriétés numériques retournent la valeur maximale exposée par tous les appareils.
L’exemple fonctionnalités de l’appareil montre comment détecter la présence d’appareils d’entrée et récupérer les fonctionnalités et les attributs de chaque appareil.
Notes
Cette classe n’est pas agile, ce qui signifie que vous devez prendre en compte son modèle de thread et son comportement de marshaling. Pour plus d’informations, consultez Threading and Marshaling (C++/CX) et Utilisation d’objets Windows Runtime dans un environnement multithread (.NET).
Is |
Obtient une valeur indiquant si l’appareil pointeur est un appareil intégré. Par exemple, un affichage vidéo avec un numériseur tactile intégré par rapport à un numériseur de stylet/stylet externe. |
Max |
Obtient une valeur indiquant le nombre maximal de contacts pris en charge par le périphérique d’entrée. |
Max |
Obtient le nombre maximal de contacts de pointage pris en charge par le périphérique d’entrée. |
Physical |
Obtient les coordonnées du rectangle englobant pris en charge par le périphérique d’entrée. |
Pointer |
Obtient le type d’appareil pointeur. |
Screen |
Obtient les coordonnées d’écran qui sont mappées au rectangle englobant pris en charge par le périphérique d’entrée. |
Supported |
Obtient une collection contenant les utilisations d’appareil pointeur prises en charge. |
Get |
Obtient des informations sur le périphérique de pointeur associé à l’ID de pointeur d’entrée spécifié. |
Get |
Obtient des informations sur les appareils pointeurs attachés au système. |