ITextInputPanel::get_DefaultInputArea-Methode (peninputpanel.h)
[ITextInputPanel ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es kann in nachfolgenden Versionen geändert oder entfernt werden. Verwenden Sie stattdessen IInputPanelConfiguration.
]
Ruft den Standardeingabebereich ab, wie von der PanelInputArea-Enumeration angegeben, oder legt diese fest.
Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.
Syntax
HRESULT get_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 keine Erkennung für die aktuelle Eingabesprache vorhanden ist.
Beispiele
In diesem C++-Beispiel wird ein ITextInputPanel-Objekt erstellt g_pTipund an das Fensterhandle eines InkEdit-Steuerelements angefügt, IDC_EDIT3indem die Eigenschaft ITextInputPanel::AttachedEditWindow festgelegt wird. Außerdem wird festgelegt und dann die Eigenschaft ITextInputPanel::D efaultInputArea 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 |