ITextInputPanel::get_PreferredInPlaceDirection 메서드(peninputpanel.h)

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

]

텍스트 입력 필드를 기준으로 현재 위치 입력 패널의 기본 방향을 가져오거나 설정합니다.

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

구문

HRESULT get_PreferredInPlaceDirection(
  InPlaceDirection *Direction
);

매개 변수

Direction

반환 값

없음

설명

애플리케이션은 현재 위치 입력 패널의 기본값이 텍스트 입력 필드 위 또는 아래에 표시되는지 여부를 지정할 수 있습니다. 이렇게 하려면 애플리케이션에서 ITextInputPanel::P referredInPlaceDirection 속성을InPlaceDirection_Bottom 또는 InPlaceDirection_Top 설정할 수 있습니다. ITextInputPanel::P referredInPlaceDirection 속성 은 현재 위치 입력 패널이 입력 패널을 화면에 유지하는 데 필요한 경우 애플리케이션에서 설정한 기본 설정을 재정의하기 때문에 기본 설정입니다. 시스템 기본값은 가능한 경우 현재 위치 입력 패널을 텍스트 필드 아래에 배치하고, 그렇지 않으면 위에 배치하는 것입니다. PreferredInPlaceDirection을 InPlaceDirection_Auto 설정하면 시스템 기본값이 복원됩니다.

예제

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

요구 사항

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

추가 정보

ITextInputPanel 인터페이스