IInkPicture::SetWindowInputRectangle-Methode (msinkaut.h)

  • Artikel

Ändert das Fensterrechteck in Pixeln, 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 von 0).
E_INK_COLLECTOR_BUSY
 Zuordnungen können während der Mitte eines Strichs nicht aktualisiert werden.
E_INK_EXCEPTION
 Innerhalb der -Methode ist eine Ausnahme aufgetreten.
E_INK_OVERLAPPING_INPUT_RECT
 Das Fenstereingaberechteck überlappt 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 überlappt.

Hinweis Überlappungen können ohne Fehler auftreten, solange zu einem bekannten Zeitpunkt nur eines der Eingaberechtecke aktiviert ist.
 
Standardmäßig ist das Fenstereingaberechteck auf {0,0,0,0}festgelegt. Dieses Standardrechteck wird der Größe des gesamten Fensters zugeordnet.

Um das Fenstereingaberechteck auf sein Standardverhalten (ein leeres {0,0,0,0}Rechteck mit Koordinaten) zurückzusetzen, ü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, wenn 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 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 Aufruf zu vermeiden, wenn Sie eine der folgenden Nachrichten behandeln: 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 Alt-Tab oder Alt-Esc Tastenkombinationen). Dies ist ein Problem mit Singlethread-Apartmentmodellanwendungen.
 

Anforderungen

Anforderung Wert
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

IInkPicture

Inkpicture