PointerDevice Klasse
Definition
Wichtig
Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.
Unterstützt die Möglichkeit, die verbundenen Zeigergeräte zu identifizieren und deren Funktionen zu bestimmen.
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
- Vererbung
- Attribute
Windows-Anforderungen
Gerätefamilie |
Windows 10 (eingeführt in 10.0.10240.0)
|
API contract |
Windows.Foundation.UniversalApiContract (eingeführt in v1.0)
|
Beispiele
Der folgende Code zeigt, wie PointerDevice verwendet wird.
/// <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;
}
}
Hinweise
Die von den hier beschriebenen Eigenschaften zurückgegebenen Werte basieren auf der Gesamtzahl der verbundenen Zeigergeräte: Boolesche Eigenschaften geben true zurück, wenn ein Gerät eine bestimmte Funktion unterstützt, und numerische Eigenschaften geben den von allen Geräten verfügbaren Maximalwert zurück.
Im Beispiel "Gerätefunktionen" wird veranschaulicht, wie Das Vorhandensein von Eingabegeräten erkannt und die Funktionen und Attribute der einzelnen Geräte abgerufen werden.
Hinweis
Diese Klasse ist nicht agil, was bedeutet, dass Sie das Threadingmodell und das Marshallverhalten berücksichtigen müssen. Weitere Informationen finden Sie unter Threading and Marshaling (C++/CX) und Using Windows-Runtime objects in a multithreaded environment (.NET).
Eigenschaften
IsIntegrated |
Ruft einen Wert ab, der angibt, ob das Zeigergerät ein integriertes Gerät ist. Beispielsweise ein Videodisplay mit einem integrierten Touch-Digitizer im Vergleich zu einem externen Stift-/Eingabestiftdigisierer. |
MaxContacts |
Ruft einen Wert ab, der die maximale Anzahl von Kontakten angibt, die vom Eingabegerät unterstützt werden. |
MaxPointersWithZDistance |
Ruft die maximale Anzahl von Zeigerkontakten ab, die vom Eingabegerät unterstützt werden. |
PhysicalDeviceRect |
Ruft die Koordinaten des begrenzungsenden Rechtecks ab, das vom Eingabegerät unterstützt wird. |
PointerDeviceType |
Ruft den Zeigergerätetyp ab. |
ScreenRect |
Ruft die Bildschirmkoordinaten ab, die dem vom Eingabegerät unterstützten umgebenden Rechteck zugeordnet sind. |
SupportedUsages |
Ruft eine Auflistung ab, die die unterstützten Zeigergeräteverwendungen enthält. |
Methoden
GetPointerDevice(UInt32) |
Ruft Informationen zum Zeigergerät ab, das der angegebenen Eingabezeiger-ID zugeordnet ist. |
GetPointerDevices() |
Ruft Informationen zu den Zeigergeräten ab, die an das System angefügt sind. |