Freigeben über


IImePad::Request-Methode (imepad.h)

Wird von einem IImePadApplet aufgerufen, um Text in eine App einzufügen.

Request ist die einzige Methode, die IImePadApplet aufrufen kann. Durch Aufrufen dieser Methode mit einer der IMEPADREQ_* -Anforderungs-IDs kann IImePadApplet Text in eine App einfügen und die Kompositionszeichenfolge von IME in einer App steuern.

Syntax

HRESULT Request(
  [in]      IImePadApplet *pIImePadApplet,
  [in]      INT           reqId,
  [in, out] WPARAM        wParam,
  [in, out] LPARAM        lParam
);

Parameter

[in] pIImePadApplet

Der Schnittstellenzeiger des aufrufenden Applets.

[in] reqId

Der Anforderungstyp (anforderungs-ID). Dies muss auf einen der folgenden Werte festgelegt werden:

Wert Bedeutung
IMEPADREQ_INSERTSTRING
Fügen Sie eine Zeichenfolge als Kompositionszeichenfolge in die App ein.
  • wParam: Zeiger auf die NULL-beendete Zeichenfolge (LPWSTR), die in die App eingefügt werden soll.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_SENDCONTROL
Steuert die Komposition der Zeichenfolge und das Caret in der App.
  • wParam: Gibt den Steuerelementwert (IMEPADCTRL_*) an, der IME anfordert, die Kompositionszeichenfolge und die Caretposition zu verarbeiten. Eine Liste der IMEPADCTRL_* -Werte finden Sie unter Hinweise.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_SETAPPLETSIZE
Legen Sie eine neue Applet-Fenstergröße fest.
  • wParam: LOWORD(wParam) gibt die Breite des Applets an. HIWORD(wParam) gibt die Höhe des Applets an
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_GETCOMPOSITIONSTRING
Ruft den aktuellen Kompositionszeichenfolgentext ab.
  • wParam: Zeigt auf den Puffer (LPWSTR), der den aktuellen Kompositionszeichenfolgentext empfangen soll.
  • lParam: Die maximale Anzahl zu kopierender Zeichen, einschließlich des beendenden NULL-Zeichens.
IMEPADREQ_GETCOMPOSITIONSTRINGINFO
Ruft Informationen zur aktuellen Kompositionszeichenfolge ab.
IMEPADREQ_DELETESTRING
Löschen Sie die Kompositionszeichenfolge.
  • wParam: LOWORD(wParam) gibt die Startposition der zu löschenden Kompositionszeichenfolge an. HIWORD(wParam) gibt die Länge der zu löschenden Kompositionszeichenfolge an.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_CHANGESTRING
Ersetzen Sie einen Teil der Kompositionszeichenfolge.
  • wParam: Zeiger auf die Ersatzzeichenfolge (LPWSTR).
  • lParam: LOWORD(lParam) gibt die Startposition der zu ersetzenden Kompositionszeichenfolge an. HIWORD(lParam) gibt die Länge der zu ersetzenden Kompositionszeichenfolge an.
IMEPADREQ_GETAPPLHWND
Ruft das Anwendungsfensterhandle ab.
  • wParam: Die HWND-Handle-Adresse (HWND *), um das Anwendungsfensterhandle zu empfangen.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_FORCEIMEPADWINDOWSHOW
Das ImePad-Fenster bleibt sichtbar.
  • wParam: TRUE , um das IMEPad-Fenster sichtbar zu halten.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_POSTMODALNOTIFY
Bewirkt , dass IImePad die Notify-Methode des Applets asynchron mit einer bestimmten Benachrichtigungs-ID und benutzerdefinierten Daten aufruft.
  • wParam: Der Benachrichtigungscode (IMEPN_*). Die möglichen IMEPN_*-Codes finden Sie unter Hinweise für IImePadApplet::Notify.
  • lParam: Benutzerdefinierte Daten
IMEPADREQ_GETDEFAULTUILANGID
Ruft die empfohlene (Standard)-ImePad-Applet-Ui-Sprache ab.
  • wParam: Adresse der Sprach-ID (LANGID *), um die Standardsprache der Benutzeroberflächen zu empfangen.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_GETCURRENTUILANG
Rufen Sie die aktuelle ImePad-Applet-Ui-Sprache ab.
  • wParam: Adresse der Sprach-ID (LANGID *), um die aktuelle Benutzeroberflächensprache zu erhalten.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_GETAPPLETUISTYLE
Ruft die Benutzeroberfläche des Applets ab (IPAWS_* -Flags).
  • wParam: Adresse zum Empfangen des Applet-UI-Stils (DWORD *). Der Stil ist eine Kombination aus IPAWS_* -Flags. Informationen zu den möglichen IPAWS_* -Flags finden Sie unter Hinweise.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_SETAPPLETUISTYLE
Legt den Ui-Stil des Applets fest (IPAWS_* -Flags).
  • wParam: Applet-UI-Stil. Der Stil ist eine Kombination aus IPAWS_* -Flags. Informationen zu den möglichen IPAWS_* -Flags finden Sie unter Hinweise.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_ISAPPLETACTIVE
Bestimmt, ob das Applet aktiv ist.
  • wParam: Adresse zum Empfangen des Werts (BOOL *). Wenn es true ist, ist das Applet aktiv. andernfalls ist das Applet nicht aktiv.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_ISIMEPADWINDOWVISIBLE
Bestimmt, ob ImePad sichtbar ist.
  • wParam: Adresse zum Empfangen des Werts (BOOL *). Wenn es true ist, ist ImePad sichtbar; Andernfalls ist ImePad nicht sichtbar.
  • lParam: Nicht verwendet. Muss auf 0 festgelegt werden.
IMEPADREQ_SETAPPLETMINMAXSIZE
Legen Sie die minimale und maximale Applet-Größe fest.
  • wParam: LOWORD(wParam) gibt die Applet-Breite an. HIWORD(wParam) gibt die Applethöhe an.
  • lParam: TRUE legt die maximale Größe fest; FALSE , um die Mindestgröße zu festlegen.
IMEPADREQ_GETCONVERSIONSTATUS
Ruft die Konvertierungs-status der aktuellen Anwendungs-IME ab. Eine vollständige Liste der Konvertierungs- und Satzmodi finden Sie in der Headerdatei Imm.h.
  • wParam: Adresse zum Empfangen des Konvertierungsmodus (DWORD *).
  • lParam: Adresse zum Empfangen des Satzmodus (DWORD *).
IMEPADREQ_GETVERSION
Ruft die Versionsinformationen von IImePad ab.
  • wParam: Adresse für den Empfang der Hauptversion (DWORD *).
  • lParam: Adresse für den Empfang der Nebenversion (DWORD *).
IMEPADREQ_GETCURRENTIMEINFO
Ruft die IME-Informationen ab, die ImePad aufgerufen haben.
  • wParam: Adresse zum Empfangen der Sprach-ID des IME (DWORD *).
  • lParam: Adresse zum Empfangen der Eingabe-ID des IME (DWORD *).

[in, out] wParam

Zusätzliche Informationen, die für reqId spezifisch sind.

[in, out] lParam

Zusätzliche Informationen, die für reqId spezifisch sind.

Rückgabewert

S_OK bei erfolgreicher Ausführung, andernfalls E_FAIL.

Hinweise

Mögliche IMEPADCTRL_* -Werte

Dies sind die möglichen Werte, die wParam übernehmen kann, wenn reqId auf IMEPADREQ_SENDCONTROL festgelegt ist:
Name Wert BESCHREIBUNG
IMEPADCTRL_CONVERTALL 1 Konvertieren Sie alle Kompositionszeichenfolgen.
IMEPADCTRL_DETERMINALL 2 Bestimmen Sie alle Kompositionszeichenfolgen.
IMEPADCTRL_DETERMINCHAR 3 Bestimmen Sie das Kompositionszeichenfolgenzeichen der angegebenen Anzahl.
IMEPADCTRL_CLEARALL 4 Löschen Sie alle Kompositionszeichenfolgen.
IMEPADCTRL_CARETLEFT 6 Verschieben Sie die Zeichenpflege nach links.
IMEPADCTRL_CARETRIGHT 7 Zeichenpflege nach rechts verschieben.
IMEPADCTRL_CARETTOP 8 Verschieben Sie das Zeichen-Caret an den Anfang der Kompositionszeichenfolge.
IMEPADCTRL_CARETBOTTOM 9 Verschieben Sie zeichenpfleget an das Ende der Kompositionszeichenfolge.
IMEPADCTRL_CARETBACKSPACE 10 Löschen Sie das Zeichen der Kompositionszeichenfolge vor dem Caret (z. B. die BACKSPACE-Taste).
IMEPADCTRL_CARETDELETE 11 Löschen Sie das Zeichen der Kompositionszeichenfolge nach dem Caret (z. B. die DELETE-Taste).
IMEPADCTRL_PHRASEDELETE 12 Löschen Sie den Ausdruck der Kompositionszeichenfolge.
IMEPADCTRL_INSERTSPACE 13 Fügen Sie ein Leerzeichen ein – je nach IME-Konfiguration volle oder halbe Breite.
IMEPADCTRL_INSERTFULLSPACE 14 Fügen Sie leer ein.
IMEPADCTRL_INSERTHALFSPACE 15 Fügen Sie einen Bereich mit halber Breite ein.
IMEPADCTRL_ONIME 16 Legen Sie IME EIN.
IMEPADCTRL_OFFIME 17 Legen Sie IME OFF fest.
IMEPADCTRL_ONPRECONVERSION 18 Legen Sie vor der Konvertierung ON fest.
IMEPADCTRL_OFFPRECONVERSION 19 Legen Sie pre-conversion OFF fest.
IMEPADCTRL_PHONETICCANDIDATE 20 Öffnen Sie den Kandidaten von IME.
 

Mögliche IPAWS_* -Werte

Dies sind die möglichen Werte, die über wParam empfangen werden können, wenn reqId auf IMEPADREQ_GETAPPLETUISTYLE festgelegt ist, oder die wParam auf festgelegt werden kann, wenn reqId auf IMEPADREQ_SETAPPLETUISTYLE festgelegt ist:
Name BESCHREIBUNG
IPAWS_ENABLED Zeigen Sie das Applet als aktiviertes Fenster an.
IPAWS_SIZINGNOTIFY Senden Sie den IMEPN_SIZECHANGING oder IMEPN_SIZECHANGED Benachrichtigungscode an das Applet.
IPAWS_VERTICALFIXED Vertikal behoben.
IPAWS_HORIZONTALFIXED Horizontal behoben.
IPAWS_SIZEFIXED Die Größe ist festgelegt.
IPAWS_MAXWIDTHFIXED Die maximale Breite ist festgelegt.
IPAWS_MAXHEIGHTFIXED Die maximale Höhe ist festgelegt.
IPAWS_MAXSIZEFIXED Die maximale Größe ist festgelegt.
IPAWS_MINWIDTHFIXED Die Mindestbreite wurde behoben.
IPAWS_MINHEIGHTFIXED Die Mindesthöhe ist behoben.
IPAWS_MINSIZEFIXED Die Mindestgröße ist behoben.

Requirements (Anforderungen)

   
Zielplattform Windows
Kopfzeile imepad.h

Weitere Informationen

IImePad

IImePadApplet

IMECOMPOSITIONSTRINGINFO