Table of Contents

There is also a listing of tables, figures, and captioned examples.

Chapter 1: Introduction to Stingray Foundation Library

• 1.1 Welcome to Stingray Foundation Library
• 1.2 Product Features
• 1.3 Location of Samples
• 1.4 Supported Platforms
• 1.5 Getting Help
• 1.5.1 Documentation
• 1.5.2 Knowledge Base
• 1.5.3 Professional Services
• 1.5.4 Technical Support
• 1.6 Licensing Restrictions

Chapter 2: Getting Started

• 2.1 Building the SFL Libraries
• 2.1.1 SFL Library Naming Conventions
• 2.2 SFL Build Configurations
• 2.3 Visual Studio Environment Setup for SFL
• 2.4 Building SFL Libraries with the Visual Studio Solution
• 2.4.1 Make Files and Building Directly with nmake
• 2.4.2 Cleaning SFL Build Targets
• 2.5 SFL Build Wizard

Chapter 3: Interface-Based Programming

• 3.1 Introduction
• 3.2 IQueryGuid and guid_cast
• 3.3 GUID Maps
• 3.4 Reference Counting

Chapter 4: Design Patterns

• 4.1 Introduction
• 4.2 The Subject-Observer Pattern
• 4.3 The Composite Pattern
• 4.4 The Object Factory Pattern
• 4.4.1 Example
• 4.5 Polymorphic Iteration
• 4.5.1 The Polymorphic Iterator Templates
• 4.5.2 The Traversable Interfaces
• 4.5.3 The Traversable Mix-in Templates
• 4.5.3.1 Lifetime Management
• 4.5.3.2 MFC and COM Collections

Chapter 5: Properties Package

• 5.1 Introduction to SFL Properties
• 5.1.1 Property Objects
• 5.2 Property Containers
• 5.2.1 A Property Container Implementation
• 5.2.1.1 The Property Map
• 5.2.1.2 Property Accessors
• 5.2.2 Property Container Example
• 5.3 ActiveX Controls
• 5.3.1 ActiveX Property Containers
• 5.3.2 Using ActiveX Property Containers

Chapter 6: Events Package

• 6.1 Introduction to SFL Events
• 6.2 Event Objects
• 6.2.1 Windows Messages
• 6.2.2 The Event Factory
• 6.2.3 Windows Message Cracking
• 6.3 Event Routers
• 6.3.1 Default Event Router Implementation
• 6.3.2 ATL Integration
• 6.3.3 MFC Integration
• 6.4 Event Listeners
• 6.4.1 Dispatching Events
• 6.4.2 Adapter Classes
• 6.4.3 Using Event Listeners
• 6.4.4 Efficiency of Event Listeners vs. Message Maps
• 6.5 Chaining Event Routers
• 6.6 Custom Event Types

Chapter 7: Layout Manager

• 7.1 Layout Manager Framework
• 7.2 Issues with Resizable Windows
• 7.3 Layout Manager Architecture
• 7.3.1 Layout Nodes
• 7.3.2 Layout Recalculation Process
• 7.3.2.1 Recalculation
• 7.3.2.2 Realization
• 7.3.3 Node Creation
• 7.3.4 Node Initialization
• 7.4 Integration with ATL
• 7.4.1 Adding Layout Management to Your Applications
• 7.5 Layout Algorithms
• 7.5.1 Scale Layout
• 7.5.2 Relative Layout
• 7.5.3 Border-Client Layout
• 7.5.4 DC Layout Nodes
• 7.5.5 Splitter Layout
• 7.5.6 Borders and Edges
• 7.6 Examples

Chapter 8: Model View Controller

• 8.1 What is MVC?
• 8.2 The MVC Design Pattern
• 8.2.1 Model-View-Controller Relationship
• 8.2.2 The Subject-Observer Pattern in MVC
• 8.2.3 Additional Reading on MVC
• 8.3 Visual Components
• 8.3.1 Visual Component Interfaces
• 8.3.2 CMvcVisualComponent
• 8.3.3 CMvcVisualPart
• 8.3.4 Coordinate Mapping
• 8.3.5 CMvcLogicalPart
• 8.3.6 Wrappers (Decorators)
• 8.3.6.1 MvcWrapper_T
• 8.3.6.2 MvcBorderWrapper_T
• 8.3.6.3 MvcScrollWrapper_T
• 8.3.7 MFC Specifics
• 8.4 MVC Models
• 8.4.1 CMvcModel
• 8.4.2 Presentation Models
• 8.4.3 MFC Specifics
• 8.5 MVC Viewports
• 8.5.1 CMvcViewport
• 8.5.2 Associating Viewports with Windows
• 8.5.3 Getting a Device Context
• 8.5.4 Event Routing
• 8.5.5 Scrolling
• 8.5.6 Zooming
• 8.5.7 ATL Specifics
• 8.5.7.1 CMvcAtlWndViewport
• 8.5.7.2 CMvcClientViewport
• 8.5.8 MFC Specifics
• 8.5.8.1 MvcViewport
• 8.5.8.2 MvcScrollView_T
• 8.5.8.3 MvcBufferedWrapper_T
• 8.6 MVC Controllers
• 8.6.1 CMvcController
• 8.6.2 MFC Specifics
• 8.7 Connecting the Model, Viewport, and Controller
• 8.7.1 CMvcComponent
• 8.7.2 ATL Specifics
• 8.8 MVC Commands and Undo/Redo
• 8.8.1 CMvcCommand
• 8.8.2 Commands as Messages
• 8.8.3 IMvcUndoRedo
• 8.8.4 MvcTransactionModel
• 8.9 MVC Principles and Practice
• 8.9.1 Minimize Coupling
• 8.9.2 Avoid "Positional Awareness" in the Controller
• 8.9.3 Use Interface-Based Programming Techniques
• 8.9.4 Use Commands to Define the Model's Services
• 8.9.5 Exploit Hierarchical Decomposition
• 8.9.6 Distinguish Between Architecture and Technology
• 8.9.7 Capture the System in the Model
• 8.9.8 Use MVC as a Widget Architecture
• 8.9.9 Distinguish Between Graphical and Non-Graphical Systems
• 8.10 Using MVC in MFC Applications
• 8.10.1 Define a Model Class
• 8.10.2 Define a Controller Class
• 8.10.3 Define a Viewport Class

Chapter 9: Print Package

• 9.1 The Print Package
• 9.2 Printable Objects
• 9.3 Print Documents
• 9.4 Printer Configurations
• 9.5 Printers
• 9.6 Print Jobs
• 9.7 Print Preview
• 9.8 Using Print Preview with ATL

Chapter 10: GDI Classes

• 10.1 SFL Graphics
• 10.2 GDI Objects
• 10.2.1 Creation and Destruction
• 10.2.2 Lifetime Management
• 10.2.3 Examples
• 10.3 Device Contexts
• 10.3.1 Device Context Creation and Destruction
• 10.3.2 MFC Compatibility

Chapter 11: String and Collection Classes

• 11.1 SFL Utility Classes
• 11.2 Enhanced String
• 11.2.1 Character Set Conversion
• 11.2.2 Casting
• 11.2.3 Formatting and Buffering
• 11.2.4 Type Definitions
• 11.3 API Structure Wrappers
• 11.4 MFC Compatibility Classes

Chapter 12: Developing Applications

• 12.1 Overview
• 12.2 Features and Benefits
• 12.3 Basic Architecture
• 12.3.1 HelloSFL
• 12.3.2 HelloSFL's Application
• 12.3.3 HelloSFL's Message Loop
• 12.3.4 HelloSFL's Main Window
• 12.4 Application Classes
• 12.4.1 CApp
• 12.4.2 CMTIApp
• 12.5 Initializer Classes
• 12.6 Windowing Classes
• 12.6.1 Container Windows
• 12.6.1.1 CContainerImplBase
• 12.6.1.2 CContainerWindowImpl
• 12.6.1.3 CContainerDialogImpl
• 12.6.2 Frame Windows
• 12.6.3 Client Windows
• 12.6.4 MDI Support
• 12.6.4.1 CMDIChildImpl
• 12.6.4.2 CMDIClientWindow
• 12.6.4.3 CMDIFrame
• 12.6.4.4 CMDIFrameImpl
• 12.6.5 Common Dialogs
• 12.6.5.1 COpenFileDialog and CSaveAsFileDialog
• 12.6.5.2 CFontDialog
• 12.6.5.3 CColorDialog
• 12.6.5.4 CFindDialog and CReplaceDialog
• 12.7 User Interface Updating
• 12.7.1 User Interface Updating Essentials

Chapter 13: The AppWizard

• 13.1 Overview
• 13.2 Conclusion

Chapter 14: Persistence Framework

• 14.1 Persistence and Property Bags
• 14.1.1 COM Property Bags
• 14.1.2 Persistable Objects
• 14.2 SFL Property Bags
• 14.2.1 Data Types
• 14.2.2 IPersistenceStrategy Interface
• 14.2.3 Registry Property Bag
• 14.2.4 XML Property Bag
• 14.2.5 Examples
• 14.3 Using Property Bags in C++ Code
• 14.3.1 MVC Integration

Chapter 15: XML Serialization Architecture

• 15.1 Overview
• 15.1.1 Usage Example
• 15.2 Architecture Classes
• 15.2.1 The XML Document Adapter class
• 15.2.2 SECXMLArchive
• 15.2.2.1 Attributes
• 15.2.2.2 Insertion Operations
• 15.2.2.3 Extraction Operations
• 15.2.2.4 Serialize Variant
• 15.2.2.5 Hierarchical nesting support
• 15.2.3 IXMLSerialize
• 15.3 XML Formatters
• 15.3.1 Built-in Formatters
• 15.3.1.1 The XML Formatter Factory
• 15.3.1.2 Collection Class Formatters
• 15.3.1.3 Other MFC types Formatters
• 15.3.2 Creating Custom Formatters
• 15.3.3 XML Serialization Support in Objective Grid and Objective Chart
• 15.4 Base64 and Quoted-Printable Encoding Classes
• 15.4.1 Content Transfer Encoding
• 15.4.2 Base64
• 15.4.3 Quoted-Printable
• 15.4.4 SFL Content-Transfer-Encoding Classes
• 15.4.5 Class Hierarchy
• 15.4.5.1 SECCTEBase
• 15.4.5.2 SECBase64Encoder
• 15.4.5.3 SECQPEncoder
• 15.4.6 Usage
• 15.4.6.1 Non-Streaming Mode
• 15.4.6.2 Streaming Mode
• 15.5 XML Framework Tutorial
• 15.5.1 The starter application
• 15.5.1.1 The starter application classes
• 15.5.2 Modifying application data classes
• 15.5.3 Adding SFL XML Support
• 15.5.3.1 stdafx.h
• 15.5.3.2 Resource includes
• 15.5.4 XML-enabling the document class
• 15.5.4.1 Using the SECXMLDocAdapter_T wrapper class
• 15.5.4.2 Modifying the base application
• 15.5.4.3 Adding menu commands
• 15.5.4.4 Menu command handlers
• 15.5.5 Creating XML formatters
• 15.5.5.1 The CXShape base class formatter
• 15.5.5.2 Implementing CXShape::XMLSerialize()
• 15.5.5.3 Creating formatters for derived CXShape classes
• 15.5.5.4 The CXDiagram formatter
• 15.5.5.5 Implementation of CXDiagramFMT::XMLSerialize()
• 15.5.6 Finishing up

Topic Index

Copyright © Rogue Wave Software, Inc. All Rights Reserved.

The Rogue Wave name and logo, and Stingray, are registered trademarks of Rogue Wave Software. All other trademarks are the property of their respective owners.
Provide feedback to Rogue Wave about its documentation.