Originally posted on http://bobhardister.com/archive/2009/03/31/implementing-a-silverlight-based-lsquoverticalrsquo-tickertape.aspx.
Introduction
I have a need of a ‘mash-up’ of business headlines for one of my current projects. For this, I want an area where headlines enter at the bottom and the other headlines scroll up, vanishing at the top. If there are no new headlines, then the first headline appears at the bottom.
Now generally when I work I like to build from the base up, build a part of the solution and then build on that. So for this reason, the article does not deal with collecting the news – I’ll leave that one for another article. This will deal with just the scrolling region.
Creating a Scrolling Region
Now to have an area of a Silverlight scroll an area, we can use the <ScrollViewer>
tag. This tag is replaced around whatever mark up we want to scroll. For the news feed or this example, this will be a StackPanel
, which will be orientated Vertical
.
<ScrollViewer x:Name="ScrollRegion"
VerticalScrollBarVisibility="Hidden"
HorizontalScrollBarVisibility="Hidden"
BorderThickness="0"
Background="White"
Height="150"
Width="200"
Cursor="Hand">
<StackPanel x:Name="ItemsStack" Orientation="Vertical" >
</StackPanel>
</ScrollViewer>
The above code creates a scrollable region containing a stack with no border, white background. At the moment, the stack panel is empty – this is because the content will be added by the code behind.
Creating Our ‘Sample’ Headings
As this is an example, just to get an idea I’m not using real headlines but the Knights of the Roundtable. This is defined as an array of string
s thus:
String[] Knights = {
"King Arthur",
"Sir Lancelot",
"Sir Gawain",
"Sir Geraint",
"Sir Gareth",
"Sir Gaheris",
"Sir Bedivere",
"Sir Galahad",
"Sir Kay",
"Sir Bors de Ganis",
"Sir Lamorak",
"Sir Tristan",
"Sir Percivale"
};
Adding Our ‘Sample’ Headings
Adding entries to our stack panel is fairly simple. We first get a reference to the stack panel, create a textblock, set the text to our next entry and add the textblock to the Children of the StackPanel
.
StackPanel sp = FindName("ItemsStack") as StackPanel;
TextBlock tb = new TextBlock();
tb.Text = Knights[0];
sp.Children.Add(tb);
Setting Up the Automatic Addition of Entries
We need our application to automatically add new entries to the news feed every so often. To do this, we need something that fires after a predetermined period of time and for this, we use the DispatchTimer
class.
DispatcherTimer dispatchTimer;
.
.
.
public Page()
{
InitializeComponent();
.
.
.
dispatchTimer = new DispatcherTimer();
dispatchTimer.Interval = new TimeSpan(0, 0, 30); dispatchTimer.Tick +=new EventHandler(dispatchTimer_Tick);
dispatchTimer.Start();
What we now need is for new headings to be added to the display each time the interval fires and for this we define a handler for the Tick
event.
Adding is the same as the section above, but there are a number of additional activities that must be dealt with when adding more than the first entry. First we need to know how much space is taken up by the new heading. Once we have added the text to it, Silverlight provides the height taken up by it from the ‘ActualHeight
’ property.
UsedHeight += tb.ActualHeight;
Next we check to see if in adding the entry, the display area needs to scroll and to do this we compare our ‘UsedHeight
’ with the actual height of the StackPanel
.
if (UsedHeight > sp.ActualHeight)
{
.
Now if it has scrolled, certain items will have vanished off the top of the region. So the application loops through each entry to see if it any part of the entry has gone over the top and then removes it.
for (i = 0; i < sp.Children.Count; i++)
{
TextBlock tbVisible = sp.Children[i] as TextBlock;
ItemHeight += tbVisible.ActualHeight;
if ((ItemHeight <= UsedHeight - sp.ActualHeight) ||
((ItemHeight - tbVisible.ActualHeight)) < (UsedHeight - sp.ActualHeight))
{
UsedHeight -= tbVisible.ActualHeight; sp.Children.RemoveAt(i); }
}
We also remove the space used by the entry from our used space counter.
And that is how to create a scrollable region. I’ll be doing the actual collection of news items later and will likely post how that works at that point.