Hi Bob,

Decided to roll my sleeves up and write some example code... here goes:

Firstly add a PlaceHolder control to your ASCX, this will be where the HTML controls for your pagination will be displayed:

<%@ Control Language="C#" AutoEventWireup="true" CodeBehind="Examine.ascx.cs" Inherits="mtt.Search.Examine" %>

<p>
    Your search for :&nbsp;<b><u><%=Term%></u></b>&nbsp;returned&nbsp;
    <i><b><%=TotalResults%></b>&nbsp; result(s)</i>
</p>
<asp:Repeater ID="rp_results" runat="server">
<ItemTemplate>
    <h4><a href='<%# theNodeName(Container)%>'><%#((Examine.SearchResult)Container.DataItem).Fields["nodeName"].ToString()%></a></h4>
    <p>
        <%# HighLightSummary(Container) %>
    </p>    
</ItemTemplate>
</asp:Repeater>

<asp:PlaceHolder runat="server" ID="phPagination" />

Note, that I've renamed "theCount" to "TotalResults" - we'll get on to that in the code bit next.

Now the code-behind:

using System;
using System.Web.UI.WebControls;

using Examine;
using Examine.LuceneEngine.SearchCriteria;
using System.Linq;
using umbraco;
using umbraco.cms;
using umbraco.BusinessLogic;
using umbraco.cms.businesslogic.media;

namespace mtt.Search
{
    public partial class Examine : System.Web.UI.UserControl
    {
        public int TotalResults { get; set; }
        public string Term { get; set; }
        public int PageNumber { get; set; }
        public int PageSize { get; set; }

        protected void Page_Load(object sender, EventArgs e)
        {
            //Create search Criteria
            var sc = ExamineManager.Instance.CreateSearchCriteria();

            //define query
            var query = sc.NodeName(Term.MultipleCharacterWildcard())
                        .Or()
                        .Field("bodyText", Term.MultipleCharacterWildcard())
                        .Or()
                        .Field("FileTextContent", Term.MultipleCharacterWildcard())
                        .Compile();

            var results = ExamineManager.Instance.SearchProviderCollection["FrontSiteSearcher"].Search(Term, true)
                .Concat(ExamineManager.Instance.SearchProviderCollection["PDFSearcher"].Search(Term, true));

            TotalResults = results.Count();

            rp_results.DataSource = results.Skip((PageNumber - 1) * PageSize).Take(PageSize);
            rp_results.DataBind();

            // pagination
            BuildPagination();
        }

        // helper to build the pagination
        private void BuildPagination()
        {
            decimal d = TotalResults / PageSize;
            var pages = Math.Round(d, 0, MidpointRounding.AwayFromZero);
            var url = Request.Url.AbsolutePath;

            if (PageNumber > 1)
            {
                var prev = new HyperLink() { NavigateUrl = string.Concat(url, "?q=", Term, "&pageNum=", PageNumber - 1), Text = "Prev" };
                phPagination.Controls.Add(prev);
            }

            for (int i = 1; i <= pages; i++)
            {
                var page = new HyperLink() { NavigateUrl = string.Concat(url, "?q=", Term, "&pageNum=", i), Text = i.ToString() };

                if (PageNumber == i)
                    page.CssClass = "current";

                phPagination.Controls.Add(page);
            }

            if (PageNumber < pages)
            {
                var next = new HyperLink() { NavigateUrl = string.Concat(url, "?q=", Term, "&pageNum=", PageNumber + 1), Text = "Next" };
                phPagination.Controls.Add(next);
            }
        }

        //simple helper to add summary of search result
        public string HighLightSummary(RepeaterItem item)
        {
            var searchResult = (SearchResult)item.DataItem;

            if (searchResult.Fields.ContainsKey("bodyText"))
                return umbraco.library.TruncateString(umbraco.library.StripHtml(searchResult.Fields["bodyText"]), 300, "...").Replace(Term, "<strong>" + Term + "</strong>");

            if (searchResult.Fields.ContainsKey("FileTextContent"))
                return umbraco.library.TruncateString(umbraco.library.StripHtml(searchResult.Fields["FileTextContent"]), 300, "...").Replace(Term, "<strong>" + Term + "</strong>");

            return string.Empty;
        }


        //simple helper to get the name of the node
        public string theNodeName(RepeaterItem item)
        {
            var theName = (SearchResult)item.DataItem;

            if (theName.Fields.ContainsKey("bodyText"))
                return umbraco.library.NiceUrl(theName.Id);

            if (theName.Fields.ContainsKey("umbracoFile"))
                return theName.Fields["umbracoFile"].ToString();

            return string.Empty;
        }

        //simple helper to get the extendion of the node
        public string theExtension(RepeaterItem item)
        {
            var theExtension = (SearchResult)item.DataItem;

            if (theExtension.Fields.ContainsKey("bodyText"))
                return "Conent Node";

            if (theExtension.Fields.ContainsKey("umbracoFile"))
                return theExtension.Fields["umbracoExtension"].ToString();

            return string.Empty;
        }
    }
}

OK, 2 big changes here. New helper method called "BuildPagination" that creates the pagination links ... and then changing "PageNumber" and "PageSize" into public properties!  Why do that? So we can leverage some Macro goodiness! :-D

In your SearchResults/Examine macro, you'll need to add the extra parameters:

• Term (text) - think you've already got this in place?
• PageNumber (number)
• PageSize (number)

Then in your MasterPage template, add those parameters - with the advanced macro syntax, you can pull in values from the querystring ... for the search term and pageNumber (with a fall-back value of "1").

<umbraco:Macro Alias="Search" Term="[@q]" PageNumber="[@pageNum],1" PageSize="10" runat="server"></umbraco:Macro>

There are probably a few tweaks to the code needed, as I've only given this a small test.

Good luck!

Cheers, Lee.