Dr. Dobb's Journal - August 2008 - (Page 39)

Clipboard Operations Go back to the WPF Compound Documents sample application and insert some PhotoControls and TimeStampControls. Select content that includes these controls, right-click the selection, and select Copy. Then verify that the copied content can be pasted. The sample app is able to copy, cut, and paste UserControls by following this procedure when content is copied (see DocumentWindow.Copy). Before copying, the Name attributes of all UserControls in the selected content are extracted by a call to GetUserControlNames (Listing Two). Then PlaceholderControls are inserted into the empty BlockUIContainers and InlineUIContainers. The inserted PlaceholderControls have the same Name attribute value as the original UserControls. This modified XAML, containing the PlaceholderControls, is copied to the clipboard. Later, when users perfom a paste, the pasted PlaceholderControls is replaced with the original UserControls. (Listing One). Once it has found a PlaceholderControl, it calls the ControlFactory to create the real UserControl. It assigns a unique Name value to this control. Then it loads the control with data that was previously saved by calling the UserControl’s Load method. Before the data is loaded into the UserControl, it is cloned. This prevents one UserControl from modifying another UserControl’s data. When the document is printed, the print code calls IEnhancedUserControl.GetPrintMarkup() and renders the XAML returned by that method. This lets a UserControl have a totally different appearance when printed. For example, when the PhotoControl is printed, none of the buttons or checkboxes are displayed. Only the selected image appears on the printed page. The print files, DocumentPaginatorWrapper.cs and Print.cs, are based on code posted in Feng Yuan’s blog (see the source code for the URL). It’s easy to add your own custom UserControls. Just make sure your UserControl implements the IEnhancedUserControl interface. Also, add your control to EnhancedUserControlUtils.ControlFactory and EnhancedUserControlUtils.ControlTypeNames. As of WPF 3.5, the support for embedded GUIs in FlowDocuments is incomplete. This situation will likely improve in subsequent versions of .NET. In the meantime, you can use the techniques in this article to create full-fledged interactive GUIs that can be embedded in FlowDocuments. DDJ IEnhancedUserControl A UserControl usually has state that must be saved before converting it into a PlaceholderControl. The same state has to be loaded when PlaceholderControl is replaced by the original UserControl. For example, when a PhotoControl is converted to a Placeholder control, the image files selected by users must be saved, along with the Slideshow checkbox state, the width and height, and the number of seconds. That’s why the PhotoControl and TimeStampControl classes implement the IEnhancedUserControl interface: public interface IEnhancedUserControl { void Save(IEnhancedUserControl enhancedUserControl, string name, ICloneable dataToPersist); void Load(ICloneable dataToPersist); string GetPrintMarkup(); string Name { get; set; } } Figure 1: User Control Demo program. Listing Two // Get control names of all UserControls in the specified document // region. public static List GetUserControlNames(TextPointer start, TextPointer end) { List userControlNames = new List (); TextPointer current = start; // Scan through the document fragment while (current.CompareTo(end) < 0) { // If we encounter something that could potentially // contain a UserControl if (current.Parent is BlockUIContainer || current.Parent is InlineUIContainer) { // Get the BlockUIContainer or InlilneUIContainer's full // XAML markup. string containerMarkup = XamlWriter.Save(current.Parent); XmlDocument xmlDocument = new XmlDocument(); xmlDocument.LoadXml(containerMarkup); // Extract the Name attribute from the XAML markup. XmlAttribute nameAttribute = xmlDocument.DocumentElement.FirstChild.Attributes["Name"]; string name = null; if (nameAttribute != null && !string.IsNullOrEmpty(nameAttribute.Value)) { name = nameAttribute.Value; } else { Debug.Assert(false); } // Store the UserControl's name in the List, avoiding // duplicates. if (!userControlNames.Contains(name)) { userControlNames.Add(name); } } current = current.GetNextContextPosition(LogicalDirection.Forward); } return userControlNames; } Because the sample app’s UserControls all implement this interface, the program can save each UserControl’s state, and restore it whenever necessary. To see the IEnhancedUserControl interface at work, take a look at EnhancedUserControlUtils.ReplacePlaceholdersWithRealControls August 2008 l www.ddj.com l Dr. Dobb’s Journal 39 http://www.ddj.com

Table of Contents Feed for the Digital Edition of Dr. Dobb's Journal - August 2008

Dr. Dobb's Journal - August 2008 Contents Friday Night Fish Fry Alia Vox Developer Diaries Developer’s Notebook A Conversation with Christos Papadimitriou OpenGL and Mobile Devices: Round 2 Ellipse Specification Using Vectors Embed Custom GUIs in WPF Building RIAs on J2EE Foundations Disentangling Concepts in Object-Oriented Systems The Agile Edge Effective Concurrency Swaine’s Flames

Dr. Dobb's Journal - August 2008

For optimal viewing of this digital publication, please enable JavaScript and then refresh the page. If you would like to try to load the digital publication without using Flash Player detection, please click here.