TextBox.CandidateWindowBoundsChanged 이벤트

정의

네임스페이스:

Microsoft.UI.Xaml.Controls

입력 메서드 편집기(IME) 창이 열리거나 업데이트되거나 닫히면 발생합니다.

// Register
event_token CandidateWindowBoundsChanged(TypedEventHandler<TextBox, CandidateWindowBoundsChangedEventArgs const&> const& handler) const;

// Revoke with event_token
void CandidateWindowBoundsChanged(event_token const* cookie) const;

// Revoke with event_revoker
TextBox::CandidateWindowBoundsChanged_revoker CandidateWindowBoundsChanged(auto_revoke_t, TypedEventHandler<TextBox, CandidateWindowBoundsChangedEventArgs const&> const& handler) const;

public event TypedEventHandler<TextBox,CandidateWindowBoundsChangedEventArgs> CandidateWindowBoundsChanged;

function onCandidateWindowBoundsChanged(eventArgs) { /* Your code */ }
textBox.addEventListener("candidatewindowboundschanged", onCandidateWindowBoundsChanged);
textBox.removeEventListener("candidatewindowboundschanged", onCandidateWindowBoundsChanged);
- or -
textBox.oncandidatewindowboundschanged = onCandidateWindowBoundsChanged;

Public Custom Event CandidateWindowBoundsChanged As TypedEventHandler(Of TextBox, CandidateWindowBoundsChangedEventArgs) 

<TextBox CandidateWindowBoundsChanged="eventhandler" />

이벤트 유형

TypedEventHandler<TextBox,CandidateWindowBoundsChangedEventArgs>

예제

여기서 사각형은 TextBox 아래에 배치됩니다. 입력 메서드 편집기(IME) 창 범위가 변경되면 TextBox의 아래쪽 여백이 IME(입력 메서드 편집기) 후보 창의 높이에 따라 증가합니다. 따라서 사각형은 해당 크기로 푸시다운되며 후보 창에서 적용되지 않습니다.

<Grid Background="{ThemeResource ApplicationPageBackgroundThemeBrush}">
    <StackPanel>
        <TextBox x:Name="textBox1" Width="300" HorizontalAlignment="Left"
                 DesiredCandidateWindowAlignment="BottomEdge"
                 CandidateWindowBoundsChanged="OnCandidateWindowBoundsChanged"/>
        <Rectangle Height="100" Width="100" Fill="Red"
                   HorizontalAlignment="Left"/>
    </StackPanel>
</Grid>

private void OnCandidateWindowBoundsChanged(TextBox sender, CandidateWindowBoundsChangedEventArgs args)
{
    textBox1.Margin = new Thickness
    {
        Left = 0,
        Top = 0,
        Right = 0,
        Bottom = Math.Max(0, args.Bounds.Bottom - textBox1.ActualHeight)
    };
}

설명

이벤트 데이터는 CandidateWindowBoundsChangedEventArgs를 참조하세요.

사용자는 텍스트 입력 상자 바로 아래의 창에 표시되는 입력 방법 편집기(IME)를 통해 텍스트를 입력하는 경우가 있습니다(일반적으로 동아시아 언어의 경우). 입력 방법 편집기(IME) 창은 사용자가 텍스트를 입력하는 동안 확인해야 할 수 있는 앱 UI의 중요한 부분을 다룰 수 있습니다. 이 이벤트는 IME(Input Method 편집기) 창이 현재 표시되는 좌표를 앱에 알립니다. 이 정보를 사용하여 IME(입력 방법 편집기) 창과 충돌하지 않는 위치에 UI를 그릴 수 있습니다.

DesiredCandidateWindowAlignment 속성을 사용하여 텍스트 입력 상자와 관련하여 IME(입력 방법 편집기) 창의 기본 배치를 지정할 수도 있습니다.

추가 정보

• DesiredCandidateWindowAlignment
• CandidateWindowBoundsChangedEventArgs