ITextInputPanel::p ut_InPlaceVisibleOnFocus 메서드(peninputpanel.h)

[ITextInputPanel 은 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 IInputPanelConfiguration을 사용합니다.

]

연결된 창에 포커스가 있을 때 태블릿 PC 입력 패널이 자동으로 표시되는지 여부를 나타내는 값을 가져오거나 설정합니다.

이 속성은 읽기/쓰기가 가능합니다.

구문

HRESULT put_InPlaceVisibleOnFocus(
  BOOL Visible
);

매개 변수

Visible

반환 값

없음

설명

컨트롤에 대해 ITextInputPanel::InPlaceVisibleOnFocus 속성이 TRUE로 설정된 경우 컨트롤이 포커스를 얻으면 태블릿 PC 입력 패널이 법적 작업인 경우 기본 InPlaceState 열거형에 자동으로 표시됩니다.

ITextInputPanel::InPlaceVisibleOnFocus 속성을FALSE로 설정하여 현재 위치 입력 패널 및 입력 패널 아이콘이 표시되지 않도록 할 수 있습니다. TRUE로 설정하면 사용자 또는 그룹 정책 사용하지 않도록 설정되지 않은 경우 가능한 경우 표시되는 시스템 기본값으로 되돌아갑니다. 이 옵션은 입력 패널 대신 사용자 지정 텍스트 입력 솔루션을 포함하는 애플리케이션에 유용합니다.

기본값은 TRUE입니다.

예제

이 C++ 예제에서는 ITextInputPanel 개체를 g_pTip만들고 ITextInputPanel::AttachedEditWindow 속성 속성을 설정하여 InkEdit 컨트롤IDC_EDIT3의 창 핸들에 연결합니다. 또한 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");
    }
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	peninputpanel.h
DLL	Tiptsf.dll

추가 정보

ITextInputPanel 인터페이스