IInkCollector::SetWindowInputRectangle-Methode (msinkaut.h)

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.

Rückgabewert

Diese Methode kann einen dieser Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Erfolg.
E_POINTER	Ein Parameter enthielt einen ungültigen Zeiger.
E_INVALIDARG	Die Rechteckkoordinaten sind ungültig (z. B. Breite/Höhe 0).
E_INK_COLLECTOR_BUSY	Zuordnungen können nicht in der Mitte eines Strichs aktualisiert werden.
E_INK_EXCEPTION	Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INK_OVERLAPPING_INPUT_RECT	Das Fenstereingaberechteck überschneidet sich mit dem Fenstereingaberechteck eines aktivierten InkCollectors.

Hinweise

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 überschneidet.

Hinweis Eine Überlappung kann ohne Fehler auftreten, solange nur eines der Eingaberechtecke zu einem bekannten Zeitpunkt aktiviert ist.

 

Standardmäßig ist das Fenstereingaberechteck auf {0,0,0,0}festgelegt. Dieses Standardrechteck entspricht der Größe des gesamten Fensters.

Um das Fenstereingaberechteck auf sein Standardverhalten zurückzusetzen (ein leeres Rechteck mit Koordinaten {0,0,0,0}), übergeben Sie {0,0,0,0} den Aufruf von SetWindowInputRectangle und nicht NULL.

Sie können kein Rechteck übergeben, bei dem der Wert der Right-Eigenschaft kleiner als der Wert der Left-Eigenschaft ist. oder, bei dem der Wert der Bottom-Eigenschaft kleiner als der Wert der Top-Eigenschaft ist. Beispielsweise ist ein Rechteck mit den Parametern {500, 500, 400, 400} ungültig.

Vorsicht Wenn Sie festlegen, dass das Fenstereingaberechteck ein Splittersteuerelement oder die Rahmen des Fensters überschneidet, können unvorhersehbare Ergebnisse auftreten, wenn die Größe des Fensters geändert wird.

 

Hinweis Das Aufrufen dieser Methode in bestimmten Nachrichtenhandlern kann dazu führen, dass die zugrunde liegende Funktion erneut eingegeben wird, was zu unerwarteten Ergebnissen führt. Vermeiden Sie beim Behandeln einer der folgenden Nachrichten einen erneuten Aufruf: 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

Unterstützte Mindestversion (Client)	Windows XP Tablet PC Edition [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	msinkaut.h
Bibliothek	InkObj.dll

Weitere Informationen

Enabled-Eigenschaft

GetWindowInputRectangle-Methode

IInkCollector

InkCollector-Klasse