Método ITextInputPanel::get_PreferredInPlaceDirection (peninputpanel.h)
[ITextInputPanel está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. En su lugar, use IInputPanelConfiguration.
]
Obtiene o establece la dirección preferida del Panel de entrada en contexto en relación con el campo de entrada de texto.
Esta propiedad es de lectura y escritura.
Sintaxis
HRESULT get_PreferredInPlaceDirection(
InPlaceDirection *Direction
);
Parámetros
Direction
Valor devuelto
None
Observaciones
Una aplicación puede especificar si el panel de entrada local tiene como valor predeterminado aparecer encima o por debajo de un campo de entrada de texto. Para ello, la aplicación puede establecer la propiedad ITextInputPanel::P referredInPlaceDirectionen InPlaceDirection_Bottom o InPlaceDirection_Top. ITextInputPanel::P referredInPlaceDirection Propiedad es una preferencia porque el Panel de entrada local invalida la preferencia establecida por la aplicación cuando sea necesario para mantener el Panel de entrada en la pantalla. El valor predeterminado del sistema es colocar el Panel de entrada en contexto debajo de un campo de texto cuando sea posible y, de lo contrario, colocarlo encima. Al establecer PreferredInPlaceDirectionen InPlaceDirection_Auto restaura el valor predeterminado del sistema.
Ejemplos
En este ejemplo de C++ se crea un objeto ITextInputPanel , g_pTipy se adjunta al identificador de ventana de un control InkEdit , IDC_EDIT3, estableciendo la propiedad ITextInputPanel::AttachedEditWindow Property . También establece y, a continuación, obtiene la propiedad ITextInputPanel::P referredInPlaceDirection.
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");
}
}
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP Tablet PC Edition [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | No se admite ninguno |
| Plataforma de destino | Windows |
| Encabezado | peninputpanel.h |
| Archivo DLL | Tiptsf.dll |