Ler em inglês

Compartilhar via


Método ITextInputPanel::p ut_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 recebe foco.

Essa propriedade é leitura/gravação.

Sintaxe

HRESULT put_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 , g_pTipe o anexa ao identificador de janela de um controle InkEdit , IDC_EDIT3, definindo a propriedade ITextInputPanel::AttachedEditWindow Property . 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

Confira também

ITextInputPanel Interface