Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Legt das Fensterrechteck in Pixel fest, in dem Freihand gezeichnet wird.
Syntax
HRESULT SetWindowInputRectangle(
[in] IInkRectangle *WindowInputRectangle
);
Parameter
[in] WindowInputRectangle
Das Rechteck in Fensterkoordinaten, auf dem Freihand gezeichnet wird.
Zurückgegebener Wert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | Beschreibung |
|---|---|
|
Erfolg. |
|
Ein Parameter enthielt einen ungültigen Zeiger. |
|
Die Rechteckkoordinaten sind ungültig (z. B. Breite/Höhe von 0). |
|
Zuordnungen können nicht in der Mitte eines Strichs aktualisiert werden. |
|
In der Methode ist eine Ausnahme aufgetreten. |
|
Das Fenstereingaberechteck überlappt mit dem Fenstereingaberechteck eines aktivierten InkCollector. |
Bemerkungen
Der E_INK_OVERLAPPING_INPUT_RECT Fehler wird zurückgegeben, wenn das Fenstereingaberechteck eines aktivierten Freihandsammlers (festgelegt mit der Enabled-Eigenschaft ) das Fenstereingaberechteck eines anderen aktivierten Freihandsammlers überlappt.
Hinweis Überlappungen können ohne Fehler auftreten, solange immer nur eines der Eingaberechtecke aktiviert ist.
Um das Fenstereingaberechteck auf das Standardverhalten (ein leeres {0,0,0,0}Rechteck mit Koordinaten) zurückzusetzen, übergeben Sie {0,0,0,0} den Aufruf an SetWindowInputRectangle und nicht AUF NULL.
Sie können kein Rechteck übergeben, bei dem der Wert der Right-Eigenschaft kleiner als der Wert der Left-Eigenschaft ist. oder wenn der Wert der Bottom-Eigenschaft kleiner als der Wert der Top-Eigenschaft ist. Ein Rechteck mit Parametern von {500, 500, 400, 400} ist beispielsweise ungültig.
Vorsicht Wenn Sie das Fenstereingaberechteck so festlegen, dass es ein Splitter-Steuerelement oder die Rahmen des Fensters überlappt, können unvorhersehbare Ergebnisse auftreten, wenn die Größe des Fensters geändert wird.
Hinweis Das Aufrufen dieser Methode innerhalb bestimmter Nachrichtenhandler kann dazu führen, dass die zugrunde liegende Funktion erneut eingegeben wird, was zu unerwarteten Ergebnissen führt. Achten Sie darauf, einen erneuten Anruf bei der Behandlung einer der folgenden Nachrichten zu vermeiden: WM_ACTIVATE, WM_ACTIVATEAPP, WM_NCACTIVATE, WM_PAINT; WM_SYSCOMMAND , wenn wParam auf SC_HOTKEY oder SC_TASKLIST festgelegt ist; und WM_SYSKEYDOWN (bei der Verarbeitung von Tastenkombinationen ALT+TAB oder ALT+ESC). Dies ist ein Problem mit Singlethread-Apartmentmodellanwendungen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Nicht unterstützt |
| Zielplattform | Windows |
| Header | msinkaut.h |