ITextInputPanel::p ut_DefaultInputArea-Methode (peninputpanel.h)
[ITextInputPanel ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen IInputPanelConfiguration.
]
Ruft den Standardeingabebereich ab, der von der PanelInputArea-Enumeration angegeben wird, oder legt diese fest.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT put_DefaultInputArea(
PanelInputArea Area
);
Parameter
Area
Rückgabewert
Keine
Bemerkungen
Der Systemstandard ist PanelInputArea_Auto, mit Ausnahme von Kennwortfeldern, in denen der Systemstandard PanelInputArea_Keyboard ist. Das Festlegen des Standardeingabebereichs überschreibt den Systemstandard in allen Fällen, außer wenn ein Eingabebereich nicht verfügbar ist, weil die aktuelle Erkennung diesen Modus nicht unterstützt oder weil es keine Erkennung für die aktuelle Eingabesprache gibt.
Beispiele
In diesem C++-Beispiel wird ein ITextInputPanel-Objekt erstellt und g_pTipan das Fensterhandle eines InkEdit-Steuerelements angefügt, IDC_EDIT3indem die Eigenschaft ITextInputPanel::AttachedEditWindow festgelegt wird. Außerdem wird festgelegt und dann die ITextInputPanel::D efaultInputArea-Eigenschaft abgerufen.
if (SUCCEEDED(CoInitialize(NULL)))
{
if (SUCCEEDED(CoCreateInstance(CLSID_TextInputPanel, NULL, CLSCTX_INPROC, IID_ITextInputPanel, (VOID**)&g_pTip)))
{
if (SUCCEEDED(g_pTip->put_AttachedEditWindow(GetDlgItem(IDC_EDIT3)->m_hWnd)))
{
g_pTip->put_DefaultInPlaceState(InPlaceState_Expanded);
InPlaceState ips;
g_pTip->get_DefaultInPlaceState(&ips);
TRACE("DefaultInplaceState: %d\n", ips);
g_pTip->put_DefaultInputArea(PanelInputArea_CharacterPad);
PanelInputArea pia;
g_pTip->get_DefaultInputArea(&pia);
TRACE("DefaultInputArea: %d\n", pia);
g_pTip->put_ExpandPostInsertionCorrection(FALSE);
BOOL epic;
g_pTip->get_ExpandPostInsertionCorrection(&epic);
TRACE("ExpandPostInsertionCorrection: %d\n", epic);
g_pTip->put_InPlaceVisibleOnFocus(TRUE);
BOOL ipvof;
g_pTip->get_InPlaceVisibleOnFocus(&ipvof);
TRACE("InPlaceVisibleOnFocus: %d\n", ipvof);
g_pTip->put_PreferredInPlaceDirection(InPlaceDirection_Top);
InPlaceDirection direction;
g_pTip->get_PreferredInPlaceDirection(&direction);
TRACE("PreferredInPlaceDirection: %d\n", direction);
}
}
else
{
TRACE("Failed to create ITextInputPanel object.\n");
}
}
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 | peninputpanel.h |
| DLL | Tiptsf.dll |