RichTextBlockOverflow.IsTextTrimmedChanged Event

Definition

Namespace:

Windows.UI.Xaml.Controls

Occurs when the IsTextTrimmed property value has changed.

// Register
event_token IsTextTrimmedChanged(TypedEventHandler<RichTextBlockOverflow, IsTextTrimmedChangedEventArgs const&> const& handler) const;

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

// Revoke with event_revoker
RichTextBlockOverflow::IsTextTrimmedChanged_revoker IsTextTrimmedChanged(auto_revoke_t, TypedEventHandler<RichTextBlockOverflow, IsTextTrimmedChangedEventArgs const&> const& handler) const;

public event TypedEventHandler<RichTextBlockOverflow,IsTextTrimmedChangedEventArgs> IsTextTrimmedChanged;

function onIsTextTrimmedChanged(eventArgs) { /* Your code */ }
richTextBlockOverflow.addEventListener("istexttrimmedchanged", onIsTextTrimmedChanged);
richTextBlockOverflow.removeEventListener("istexttrimmedchanged", onIsTextTrimmedChanged);
- or -
richTextBlockOverflow.onistexttrimmedchanged = onIsTextTrimmedChanged;

Public Custom Event IsTextTrimmedChanged As TypedEventHandler(Of RichTextBlockOverflow, IsTextTrimmedChangedEventArgs) 

<RichTextBlockOverflow IsTextTrimmedChanged="eventhandler"/>

Event Type

TypedEventHandler<RichTextBlockOverflow,IsTextTrimmedChangedEventArgs>

Windows requirements

Device family	Windows 10 Fall Creators Update (introduced in 10.0.16299.0)
API contract	Windows.Foundation.UniversalApiContract (introduced in v5.0)

Examples

In this example, we construct a three column layout using a RichTextBlock and two RichTextBlockOverflow controls. We set the TextTrimming property of the RichTextBlock to CharacterEllipsis and bind it to the first RichTextBlockOverflow, which is then bound to the second RichTextBlockOverflow.

Resizing the window causes the columns to resize, which triggers the IsTextTrimmedChanged event.

<StackPanel>
    <Grid x:Name="ColumnGrid" Height="200">
        <Grid.ColumnDefinitions>
            <ColumnDefinition />
            <ColumnDefinition />
            <ColumnDefinition />
        </Grid.ColumnDefinitions>
        <RichTextBlock Grid.Column="0" Margin="12,0" 
                        OverflowContentTarget="{x:Bind firstOverflowContainer}"
                        TextAlignment="Justify" TextTrimming="CharacterEllipsis"                         
                        IsTextTrimmedChanged="RichTextBlock_IsTextTrimmedChanged">
            <Paragraph>
                Linked text containers allow text which does not fit in one element 
                to overflow into a different element on the page. Creative use of 
                linked text containers enables basic multicolumn support and other 
                advanced page layouts.
            </Paragraph>
            <Paragraph>
                Duis sed nulla metus, id hendrerit velit. Curabitur dolor purus, 
                bibendum eu cursus lacinia, interdum vel augue. Aenean euismod 
                eros et sapien vehicula dictum. Duis ullamcorper, turpis nec 
                feugiat tincidunt, dui erat luctus risus, aliquam accumsan 
                lacus est vel quam. Nunc lacus massa, varius eget accumsan id, 
                congue sed orci. Duis dignissim hendrerit egestas. Proin ut 
                turpis magna, sit amet porta erat. Nunc semper metus nec magna 
                imperdiet nec vestibulum dui fringilla. Sed sed ante libero, 
                nec porttitor mi. Ut luctus, neque vitae placerat egestas, 
                urna leo auctor magna, sit amet ultricies ipsum felis quis 
                sapien. Proin eleifend varius dui, at vestibulum nunc 
                consectetur nec. Mauris nulla elit, ultrices a sodales non, 
                aliquam ac est. Quisque sit amet risus nulla. Quisque 
                vestibulum posuere velit, vitae vestibulum eros scelerisque 
                sit amet. In in risus est, at laoreet dolor. Nullam aliquet 
                pellentesque convallis. Ut vel tincidunt nulla. Mauris auctor 
                tincidunt auctor.
                Aenean orci ante, vulputate ac sagittis sit amet, consequat at mi. 
                Morbi elementum purus consectetur nisi adipiscing vitae blandit 
                sapien placerat. Aliquam adipiscing tortor non sem lobortis 
                consectetur mattis felis rhoncus. Nunc eu nunc rhoncus arcu 
                sollicitudin ultrices. In vulputate eros in mauris aliquam id 
                dignissim nisl laoreet.
            </Paragraph>
        </RichTextBlock>
        <RichTextBlockOverflow x:Name="firstOverflowContainer" Grid.Column="1"  Margin="12,0"
                                IsTextTrimmedChanged="OverflowContainer_IsTextTrimmedChanged"
                                OverflowContentTarget="{x:Bind secondOverflowContainer}" />
        <RichTextBlockOverflow x:Name="secondOverflowContainer" Grid.Column="2" Margin="12,0" 
                                IsTextTrimmedChanged="OverflowContainer_IsTextTrimmedChanged"/>
    </Grid>
</StackPanel>

namespace TextTrimming1
{
    /// <summary>
    /// An empty page that can be used on its own or navigated to within a Frame.
    /// </summary>
    public sealed partial class MainPage : Page
    {
        public MainPage()
        {
            this.InitializeComponent();
        }

        private void RichTextBlock_IsTextTrimmedChanged(RichTextBlock sender, IsTextTrimmedChangedEventArgs args)
        {
            if (sender.IsTextTrimmed)
            {
                //do something
            }
        }

        private void OverflowContainer_IsTextTrimmedChanged(RichTextBlockOverflow sender, IsTextTrimmedChangedEventArgs args)
        {
            if (sender.IsTextTrimmed)
            {
                ColumnGrid.Height += 100;
            }
        }
    }
}

Remarks

If the TextTrimming property of RichTextBlock/TextBlock is set to None (default), no trim indicator is drawn and the IsTextTrimmedChanged event does not fire.