Método ITextInputPanel::get_InPlaceVisibleOnFocus (peninputpanel.h)
[ITextInputPanel está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele poderá ser alterado ou ficar indisponível em versões subsequentes. Em vez disso, use IInputPanelConfiguration.
]
Obtém ou define um valor que indica se o Painel de Entrada do Tablet PC é exibido automaticamente quando a janela à qual ele está anexado fica em foco.
Essa propriedade é leitura/gravação.
Sintaxe
HRESULT get_InPlaceVisibleOnFocus(
BOOL *Visible
);
Parâmetros
Visible
Valor retornado
Nenhum
Comentários
Se a propriedade ITextInputPanel::InPlaceVisibleOnFocus estiver definida como TRUE para um controle, quando o controle ganhar foco, o Painel de Entrada do Tablet PC será exibido automaticamente na Enumeração InPlaceState padrão, desde que seja uma operação legal.
É possível impedir que o Painel de Entrada in-loco e o Ícone do Painel de Entrada apareçam definindo a Propriedade ITextInputPanel::InPlaceVisibleOnFocus como FALSE. Defini-lo como TRUE reverte-o para o padrão do sistema de aparecer quando possível, desde que não tenha sido desabilitado pelo usuário ou Política de Grupo. Essa opção é útil para aplicativos que incluem soluções de entrada de texto personalizadas como uma alternativa ao Painel de Entrada.
O valor padrão é TRUE.
Exemplos
Este exemplo C++ cria um objeto ITextInputPanel e g_pTipo anexa ao identificador de janela de um controle InkEdit , IDC_EDIT3, definindo a propriedade Propriedade ITextInputPanel::AttachedEditWindow . Ele também define e obtém a propriedade ITextInputPanel::InPlaceVisibleOnFocus.
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 | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP Tablet PC Edition [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | peninputpanel.h |
| DLL | Tiptsf.dll |