smartclient Wiki & Documentation Rss Feed

New Comment on "Commands and Events"

narimj — Wed, 04 Jul 2012 17:23:00 GMT

CommandHandler(http://www.cabpedia.com/index.php?title=CommandHandler) SCSF Version: all Description: How to declare, invoke, execute and change the status of a Command This link is dead.

New Comment on "Hands-On-Labs"

atdushi — Mon, 06 Jun 2011 07:03:21 GMT

year 2011, still coming soon... are you so loaded with prism?

New Comment on "GettingStartedwiththeSmartClientSoftwareFactory2010"

chrislew — Mon, 07 Feb 2011 10:28:51 GMT

Step #3 - To add a Hello World view. Could not find the Smart Client Software Factory menu item when I right-click the HelloWorldModule. It only shows when I right click the Modules or WebSites solution folders, or the Website item. Any ideas?

New Comment on "Getting Started with the Smart Client Software Factory"

andersoyvind — Wed, 11 Aug 2010 12:04:40 GMT

@mrooney: Maybe you should start reflect on why they don't include vb.net-samples in a Best Practices-project. Maybe that is just part of the idea.

Updated Wiki: Known Issues / Fixes

fantivero — Wed, 23 Jun 2010 16:42:12 GMT

Known Issues / Fixes

SmartClient: Exception Handling and CAB
- SCSF Version: 2010
- Description: Article that provides a workaround to the sudden close of a SCSF application after throwing an unhandled exception.

SmartClient: Changing the Projects File System Structure
- SCSF Version: All
- Description: Article that provides a workaround to the error adding a new Business module with a recipe.

SCSF Solution file is checked out from TFS when it is opened in Visual Studio 2008 SP1
- SCSF Version: All
- Description: Article that provides a workaround to avoid that the SCSF solution file was checked out from Team Foundational Server (TFS) when it is opened in Visual Studio 2008 SP1.

Workaround for the "Unhandled Exceptions in Release Mode" issue
- SCSF Version: All
- Description: Unhandled Exceptions are not correctly handled when running the application without debugging. Workaround using the Application.ThreadException event.

Using Smart Client Software Factory with Enterprise Library 4.1
- SCSF Version: April 2008
- Description: An article that describes the steps required to upgrade the Smart Client Software Factory - April 2008 to use the Enterprise Library 4.1.

Workaround for the Add Business Module (VB) recipe issue
- SCSF Version: All
- Description: CAB assemblies references have a double slash in their path in the Business Modules (VB).

Workaround for DeckWorkspace issue: The smartpart is not present in the workspace
- SCSF Version: All
- Description: Workaround for the exception: The smartpart is not present in the workspace, when showing several views in a DeckWorkspace.

Memory Leak Issues
- SCSF Version: May 2007
- Description: The memory usage grows when opening and closing views. Bugs in SCSF - May 2007 templates (fixed in SCSF - April 2008 release) and a bug in the DeckWorkspace not fixed jet.

Known Issues: SC-SF April 2008 with Visual Studio 2008 and SP1 Beta
- SCSF Version: April 2008
- Description: Fixes for the following issues in the Guidance Package:
  - Add View (with presenter) recipes do not appear.
  - New SC-SF solutions do not run.

Fix for Performance Issue with Visual Source Safe and Perforce
- SCSF Version: All
- Description: Fix for Guidance Package performance issue (projects and contextual menus loading slow) when using Visual Source Safe or Perforce.

Known Issues with the Smart Client Software Factory April 2008
- ‌‌SCSF Version:‌‌‌ ‌April 2008
- ‌‌Description: Known issues present in Smart Client Software Factory - April 2008.

HowTo: avoid CAB TabWorkspace flickering
- ‌‌SCSF Version:‌‌‌ ‌1.0
- ‌‌Description: Solution for avoid the TabWorkspace flickering issue.

SCSF Installation Patch Available for C#
- ‌‌SCSF Version:‌‌‌ ‌2.0
- ‌‌Description: Install Smart Client Software Factory without having installed‌VB.NET on your machine.

Installation failed because both VB.NET and C# need to be registered on your machine
- SCSF Version: 2.0
- Description: Install Smart Client Software Factory without having installed‌VB.NET on your machine.

WebBrowser Control causes View to throw NullReferenceException on OnLoad()
- ‌‌SCSF Version:‌‌‌‌ 1.0
- ‌‌Description‌: Workaround for this issue with the WebBrowser control.

Behaviour of ShowViewInWorkspace
- SCSF Version: 2.0
- Description: ShowViewInWorkspace<TView>(string viewId, string workspaceName) is not applying the id. (C# only).

Exception Handling error
- SCSF Version: 2.0
- Description: App.config is not using the signed assemblies (PublicKeyToken is null).

Error with WPF SmartParts and ISmartPartInfoProvider
- SCSF Version: 2.0
- Description: With WPF: GetSmartPartInfo method is never called regarding to an issue in the ElementHostWorkspace’s Show method.

WPF: Modal Window in SCSF
- SCSF Version: 1.1
- Description: How to use a WPF SmartPart as a Modal Window in a WindowWorkspace.

Error when try to add a Business Module
- SCSF Version: All
- Description: Question about this error: "An exception occurred during the binding of reference or execution of recipe CreateBusinessModule. Error was: The following arguments are required and don’t have values: ShellProject. Can’t continue execution".

Unable to install CAB on Vista
- SCSF Version: All
- Description: How to solve the “An unexpected error occurred generating the Visual Studio Solution files. You may have to manually create solution files for the projects you have installed” exception during the installation of CAB.

Rebuilding SCSF Guidance Package
- SCSF Version: 2.0
- Description: Solution when you have missing GAT references in the Guidance Package.

Smart Client Factory + ModuleLoadException
- SCSF Version: 2.0
- Description: Solution when a exception of type 'Microsoft.Practices.CompositeUI.Services.ModuleLoadException' occurred in Infrastructure.Library.dll.

Can not create test project
- SCSF Version: 2.0
- Description: Problem about how to create a test project in SCSF.

MDI content resizing
- SCSF Version: all
- Description: There is a bug in MDIWorkspace container: the content control's size stay always the same. Dock or anchor properties in design mode are dead.

SmartParts do not get disposed on WorkItem.Terminate()
- SCSF Version: 2.0
- Description: Issue: When you terminate a WorkItem, the SmartParts are not disposed.

How To: Dispose a view (SmartPart) when using CAB and SCSF
- SCSF Version: all
- Description: A complete workaround to dispose views in CAB and SC-SF.

Customizing the documentation
- SCSF Version: all
- Description: After the SC-SF documentation has been compiled by HelpStudio Lite, it contains no images, and it displays a runtime error.

User Control cannot automatically been added to toolbox
- SCSF Version: all
- Description: How to get user controls added to the toolbox when we have the project in solution folders.

CreateBusinessModuleCS exception
- SCSF Version: All
- Description: Tips to solve recipes exceptions.

Workaround - WindowWorkspace closing sequence
- SCSF Version: All
- Description: Blog post: Workaround and fixes on the closing sequence of a view in a WindowWorkspace by pressing ALT+F4 or clicking the "X" on the form.

Updated Wiki: Known Issues / Fixes

fantivero — Wed, 23 Jun 2010 16:35:46 GMT

Known Issues / Fixes

SmartClient: Exception Handling and CAB
- SCSF Version: 2010
- Description: Article that provides a workaround to the suddenly close of a SCSF application after throwing an unhandled exception.

SmartClient: Changing the Projects File System Structure
- SCSF Version: All
- Description: Article that provides a workaround to the error adding a new Business module with a recipe.

SCSF Solution file is checked out from TFS when it is opened in Visual Studio 2008 SP1
- SCSF Version: All
- Description: Article that provides a workaround to avoid that the SCSF solution file was checked out from Team Foundational Server (TFS) when it is opened in Visual Studio 2008 SP1.

Workaround for the "Unhandled Exceptions in Release Mode" issue
- SCSF Version: All
- Description: Unhandled Exceptions are not correctly handled when running the application without debugging. Workaround using the Application.ThreadException event.

Using Smart Client Software Factory with Enterprise Library 4.1
- SCSF Version: April 2008
- Description: An article that describes the steps required to upgrade the Smart Client Software Factory - April 2008 to use the Enterprise Library 4.1.

Workaround for the Add Business Module (VB) recipe issue
- SCSF Version: All
- Description: CAB assemblies references have a double slash in their path in the Business Modules (VB).

Workaround for DeckWorkspace issue: The smartpart is not present in the workspace
- SCSF Version: All
- Description: Workaround for the exception: The smartpart is not present in the workspace, when showing several views in a DeckWorkspace.

Memory Leak Issues
- SCSF Version: May 2007
- Description: The memory usage grows when opening and closing views. Bugs in SCSF - May 2007 templates (fixed in SCSF - April 2008 release) and a bug in the DeckWorkspace not fixed jet.

Known Issues: SC-SF April 2008 with Visual Studio 2008 and SP1 Beta
- SCSF Version: April 2008
- Description: Fixes for the following issues in the Guidance Package:
  - Add View (with presenter) recipes do not appear.
  - New SC-SF solutions do not run.

Fix for Performance Issue with Visual Source Safe and Perforce
- SCSF Version: All
- Description: Fix for Guidance Package performance issue (projects and contextual menus loading slow) when using Visual Source Safe or Perforce.

Known Issues with the Smart Client Software Factory April 2008
- ‌‌SCSF Version:‌‌‌ ‌April 2008
- ‌‌Description: Known issues present in Smart Client Software Factory - April 2008.

HowTo: avoid CAB TabWorkspace flickering
- ‌‌SCSF Version:‌‌‌ ‌1.0
- ‌‌Description: Solution for avoid the TabWorkspace flickering issue.

SCSF Installation Patch Available for C#
- ‌‌SCSF Version:‌‌‌ ‌2.0
- ‌‌Description: Install Smart Client Software Factory without having installed‌VB.NET on your machine.

Installation failed because both VB.NET and C# need to be registered on your machine
- SCSF Version: 2.0
- Description: Install Smart Client Software Factory without having installed‌VB.NET on your machine.

WebBrowser Control causes View to throw NullReferenceException on OnLoad()
- ‌‌SCSF Version:‌‌‌‌ 1.0
- ‌‌Description‌: Workaround for this issue with the WebBrowser control.

Behaviour of ShowViewInWorkspace
- SCSF Version: 2.0
- Description: ShowViewInWorkspace<TView>(string viewId, string workspaceName) is not applying the id. (C# only).

Exception Handling error
- SCSF Version: 2.0
- Description: App.config is not using the signed assemblies (PublicKeyToken is null).

Error with WPF SmartParts and ISmartPartInfoProvider
- SCSF Version: 2.0
- Description: With WPF: GetSmartPartInfo method is never called regarding to an issue in the ElementHostWorkspace’s Show method.

WPF: Modal Window in SCSF
- SCSF Version: 1.1
- Description: How to use a WPF SmartPart as a Modal Window in a WindowWorkspace.

Error when try to add a Business Module
- SCSF Version: All
- Description: Question about this error: "An exception occurred during the binding of reference or execution of recipe CreateBusinessModule. Error was: The following arguments are required and don’t have values: ShellProject. Can’t continue execution".

Unable to install CAB on Vista
- SCSF Version: All
- Description: How to solve the “An unexpected error occurred generating the Visual Studio Solution files. You may have to manually create solution files for the projects you have installed” exception during the installation of CAB.

Rebuilding SCSF Guidance Package
- SCSF Version: 2.0
- Description: Solution when you have missing GAT references in the Guidance Package.

Smart Client Factory + ModuleLoadException
- SCSF Version: 2.0
- Description: Solution when a exception of type 'Microsoft.Practices.CompositeUI.Services.ModuleLoadException' occurred in Infrastructure.Library.dll.

Can not create test project
- SCSF Version: 2.0
- Description: Problem about how to create a test project in SCSF.

MDI content resizing
- SCSF Version: all
- Description: There is a bug in MDIWorkspace container: the content control's size stay always the same. Dock or anchor properties in design mode are dead.

SmartParts do not get disposed on WorkItem.Terminate()
- SCSF Version: 2.0
- Description: Issue: When you terminate a WorkItem, the SmartParts are not disposed.

How To: Dispose a view (SmartPart) when using CAB and SCSF
- SCSF Version: all
- Description: A complete workaround to dispose views in CAB and SC-SF.

Customizing the documentation
- SCSF Version: all
- Description: After the SC-SF documentation has been compiled by HelpStudio Lite, it contains no images, and it displays a runtime error.

User Control cannot automatically been added to toolbox
- SCSF Version: all
- Description: How to get user controls added to the toolbox when we have the project in solution folders.

CreateBusinessModuleCS exception
- SCSF Version: All
- Description: Tips to solve recipes exceptions.

Workaround - WindowWorkspace closing sequence
- SCSF Version: All
- Description: Blog post: Workaround and fixes on the closing sequence of a view in a WindowWorkspace by pressing ALT+F4 or clicking the "X" on the form.

Updated Wiki: SCSF Knowledge Base

fantivero — Wed, 23 Jun 2010 16:35:38 GMT

Smart Client Software Factory Knowledge Base

The purpose of this Knowledge Base is categorize and organize blogs posts, CodePlex pages, CodePlex posts, etc that can be valuable for the community. With this kind of information organized the community will have a new place to search for help/guidance.

We are going to update this KB periodically. You will find highlighted in this page the new posts we are adding.

Below this you will find the categories in which we propose to organize the information. If you feel that some categories are missing, please leave us a comment with the proposed category.

New posts:

More...

Updated Wiki: New posts

fantivero — Wed, 23 Jun 2010 16:35:34 GMT

New Posts

Updated Wiki: Home

hanz — Fri, 21 May 2010 23:44:31 GMT

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Documentation is now available for download.

Smart Client Software Factory 2010 Getting Started Guide is now available

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

The Smart Client Software Factory is a guidance offering that provides comprehensive architecture guidance to help customers build Composite Smart Clients using the Microsoft platform (Win Forms, WPF, etc). An SCSF solution is composed of a number of discrete, independent, yet functional assemblies and components. These pieces are dynamically loaded and integrated together at runtime within a shell to form a fully coherent application.

Getting Started

The Getting Started provides recommendations on how to quickly use the guidance available in this factory.

Click here to download the Smart Client Software Factory - April 2008 release.
Click here for detailed instructions on Installing the factory or Upgrade From Previous Releases.
Click here if you want to download only the Source Code Installer
Click here if you want to download only the Smart Client Software Factory Documentation.
Click here for a list of Known Issues.
Click here to download the Mobile Client Software Factory - July 2006 release.
Click here to go to the site of patterns & practices: Mobile Application Blocks that are currently being developed. The updated blocks are based on the Mobile Client Software Factory v1, July 2006. The update will allow developers to build mobile applications based on VS2008, .NET CF 3.5 and WM6.1.

Where to go next?

Action	Link
Read about the April 2008 release of the factory	SCSF MSDN Landing page
View recent announcements for the Smart Client program	Announcements
See a list of resources for getting started with SCSF	Learning Resources
Explore our compilation of tips, tricks and guidance from the Smart Client team and the community	SCSF Knowledge Base
Read blog postings from the team	Team Blogs
If you want to develop applications targeting mobile devices with VS2005, .NET2.0 and WM5.0, read about the Mobile Client Software Factory July 2006 release	MCSF MSDN Landing page
If you want to develop applications targeting mobile devices with VS2008, .NET3.5 and WM6.1, read about the patterns & practices: Mobile Application Blocks	patterns & practices: Mobile Application Blocks

Participation

The factory is developed using the open process used by patterns & practices for all of its deliverables. This process includes frequent builds and releases in this community of code and documentation. If you find bugs or want additional capabilities addressed by the team, use the Issue Tracker to create a new Work Item.

You can influence this project. Please send us feedback!

Our team will continuously monitor the forums in this site to get feedback on content and to help us prioritize.

You can also fill the p&p Survey. Let us know which p&p assets you use/ or used and how satisfied you are with p&p assets and of course, overall with p&p: patterns & practices Survey

Thanks!
p&p Client Team

Updated Wiki: Home

hanz — Fri, 21 May 2010 23:43:15 GMT

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Documentation is now available for download.

Smart Client Software Factory 2010 Getting Started Guide is now available

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

The Getting Started provides recommendations on how to quickly use the guidance available in this factory.

Click here to download the Smart Client Software Factory - April 2008 release.
Click here for detailed instructions on Installing the factory or Upgrade From Previous Releases.
Click here if you want to download only the Source Code Installer
Click here if you want to download only the Smart Client Software Factory Documentation.
Click here for a list of Known Issues.
Click here to download the Mobile Client Software Factory - July 2006 release.
Click here to go to the site of patterns & practices: Mobile Application Blocks that are currently being developed. The updated blocks are based on the Mobile Client Software Factory v1, July 2006. The update will allow developers to build mobile applications based on VS2008, .NET CF 3.5 and WM6.1.

Where to go next?

Action	Link
Read about the April 2008 release of the factory	SCSF MSDN Landing page
View recent announcements for the Smart Client program	Announcements
See a list of resources for getting started with SCSF	Learning Resources
Explore our compilation of tips, tricks and guidance from the Smart Client team and the community	SCSF Knowledge Base
Read blog postings from the team	Team Blogs
If you want to develop applications targeting mobile devices with VS2005, .NET2.0 and WM5.0, read about the Mobile Client Software Factory July 2006 release	MCSF MSDN Landing page
If you want to develop applications targeting mobile devices with VS2008, .NET3.5 and WM6.1, read about the patterns & practices: Mobile Application Blocks	patterns & practices: Mobile Application Blocks

Participation

Updated Wiki: Home

hanz — Fri, 21 May 2010 23:42:38 GMT

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Documentation is now available for download.

Smart Client Software Factory 2010 Getting Started Guide

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

The Getting Started provides recommendations on how to quickly use the guidance available in this factory.

Click here to download the Smart Client Software Factory - April 2008 release.
Click here for detailed instructions on Installing the factory or Upgrade From Previous Releases.
Click here if you want to download only the Source Code Installer
Click here if you want to download only the Smart Client Software Factory Documentation.
Click here for a list of Known Issues.
Click here to download the Mobile Client Software Factory - July 2006 release.
Click here to go to the site of patterns & practices: Mobile Application Blocks that are currently being developed. The updated blocks are based on the Mobile Client Software Factory v1, July 2006. The update will allow developers to build mobile applications based on VS2008, .NET CF 3.5 and WM6.1.

Where to go next?

Action	Link
Read about the April 2008 release of the factory	SCSF MSDN Landing page
View recent announcements for the Smart Client program	Announcements
See a list of resources for getting started with SCSF	Learning Resources
Explore our compilation of tips, tricks and guidance from the Smart Client team and the community	SCSF Knowledge Base
Read blog postings from the team	Team Blogs
If you want to develop applications targeting mobile devices with VS2005, .NET2.0 and WM5.0, read about the Mobile Client Software Factory July 2006 release	MCSF MSDN Landing page
If you want to develop applications targeting mobile devices with VS2008, .NET3.5 and WM6.1, read about the patterns & practices: Mobile Application Blocks	patterns & practices: Mobile Application Blocks

Participation

Updated Wiki: Home

hanz — Fri, 21 May 2010 23:37:24 GMT

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

The Getting Started provides recommendations on how to quickly use the guidance available in this factory.

Click here to download the Smart Client Software Factory - April 2008 release.
Click here for detailed instructions on Installing the factory or Upgrade From Previous Releases.
Click here if you want to download only the Source Code Installer
Click here if you want to download only the Smart Client Software Factory Documentation.
Click here for a list of Known Issues.
Click here to download the Mobile Client Software Factory - July 2006 release.
Click here to go to the site of patterns & practices: Mobile Application Blocks that are currently being developed. The updated blocks are based on the Mobile Client Software Factory v1, July 2006. The update will allow developers to build mobile applications based on VS2008, .NET CF 3.5 and WM6.1.

Where to go next?

Action	Link
Read about the April 2008 release of the factory	SCSF MSDN Landing page
View recent announcements for the Smart Client program	Announcements
See a list of resources for getting started with SCSF	Learning Resources
Explore our compilation of tips, tricks and guidance from the Smart Client team and the community	SCSF Knowledge Base
Read blog postings from the team	Team Blogs
If you want to develop applications targeting mobile devices with VS2005, .NET2.0 and WM5.0, read about the Mobile Client Software Factory July 2006 release	MCSF MSDN Landing page
If you want to develop applications targeting mobile devices with VS2008, .NET3.5 and WM6.1, read about the patterns & practices: Mobile Application Blocks	patterns & practices: Mobile Application Blocks

Participation

Updated Wiki: Home

hanz — Fri, 21 May 2010 23:37:02 GMT

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 RC is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 RC is now available for download.

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

The Getting Started provides recommendations on how to quickly use the guidance available in this factory.

Click here to download the Smart Client Software Factory - April 2008 release.
Click here for detailed instructions on Installing the factory or Upgrade From Previous Releases.
Click here if you want to download only the Source Code Installer
Click here if you want to download only the Smart Client Software Factory Documentation.
Click here for a list of Known Issues.
Click here to download the Mobile Client Software Factory - July 2006 release.
Click here to go to the site of patterns & practices: Mobile Application Blocks that are currently being developed. The updated blocks are based on the Mobile Client Software Factory v1, July 2006. The update will allow developers to build mobile applications based on VS2008, .NET CF 3.5 and WM6.1.

Where to go next?

Action	Link
Read about the April 2008 release of the factory	SCSF MSDN Landing page
View recent announcements for the Smart Client program	Announcements
See a list of resources for getting started with SCSF	Learning Resources
Explore our compilation of tips, tricks and guidance from the Smart Client team and the community	SCSF Knowledge Base
Read blog postings from the team	Team Blogs
If you want to develop applications targeting mobile devices with VS2005, .NET2.0 and WM5.0, read about the Mobile Client Software Factory July 2006 release	MCSF MSDN Landing page
If you want to develop applications targeting mobile devices with VS2008, .NET3.5 and WM6.1, read about the patterns & practices: Mobile Application Blocks	patterns & practices: Mobile Application Blocks

Participation

Updated Wiki: GettingStartedwiththeSmartClientSoftwareFactory2010

hanz — Fri, 21 May 2010 20:27:57 GMT

Getting Started with the Smart Client Software Factory 2010

Are you new to the Smart Client Software Factory? The best way to get familiar with the Smart Client Software Factory is to do the following:

Build a Hello World application. For information about how to do this, see the section, Create Your Hello World Application, that follows.
Run the QuickStarts included with the software factory. The BankTeller QuickStart helps you understand the Composite UI Application Block, which is now included with the software factory. For information about the QuickStarts, see the "QuickStarts" topic in the documentation.
Download and complete the Hands-on-Labs.
Review the "Exploring the Smart Client Software Factory" topic in the documentation.

Just want to review the documentation

If you are in the evaluation phase of the factory, you can download the documentation before downloading the factory. Then when you are ready, you can download the factory.

Create Your Hello World Application

This section describes how to create and display a view using the software factory. To create your first Hello World application, perform the procedures in this section.

Note: The following procedures require the guidance package to be installed.

To create a new smart client application project

In Visual Studio 2010, point to New on the File menu, and then click Project.
In the New Project dialog box, expand Guidance Packages Project, and then select Smart Client Development May 2010.
Select the Smart Client Application (C#) Visual Studio template.
In the Name box, type HelloWorldApplication, and then click OK.
In the wizard, accept the default settings, and then click Finish.

To create a Hello World module

In Solution Explorer, right-click the solution, point to Smart Client Software Factory, and then click Add Business Module (C#).
In the Add New Project dialog box, type HelloWorldModule in the Name box.
Click OK.
In the wizard, accept the default settings, and then click Finish.

To add a Hello World view

In Solution Explorer, right-click HelloWorldModule, point to Smart Client Software Factory, and then click Add View (with presenter).
In the Add New View (with presenter) dialog box, type HelloWorldView in the View box, and then click Finish.
In Solution Explorer, double-click the file HelloWorldView.cs to view it in the Designer.* Drag a text box onto the view, and set the text to Hello World*.

To configure HelloWorldView to display on the shell's right workspace

1. In Solution Explorer, open ModuleController.cs in the HelloWorldModule project.
2. Add the following code.

C#
 using HelloWorldApplication.Infrastructure.Interface.Constants;

3. In the AddViews method, add the following code.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and show
 // the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

4. Press F5 to build and run your Hello World application.
5. On the File menu, click Exit.

Next, you will associate a command with a menu item to display the Hello World text box.

To extend your first Hello World application to use a toolbar and command

1. Comment out the following code in the AddViews method in the ModuleController.cs file so that the text box does not automatically appear.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

2. Extend the main toolbar:
a. In Solution Explorer, expand the Constants folder under the HelloWorldModule project, and then double-click CommandNames.cs to open the file.
b. Add the following code to the CommandNames class. This defines the ShowHelloWorldMessage command constant.

 C#
 // A command is an abstraction of UI elements events,
 // such as the click of a button. 
     public const string ShowHelloWorldMessage = "ShowHelloWorldMessage";

c. In Solution Explorer, under the HelloWorldModule project, double-click ModuleController.cs to open the file.
d. Add the following code to the ExtendToolStrip method.

 C#
    AddToolStripButton(Constants.CommandNames.ShowHelloWorldMessage, "Hello World");

e. Add the following code to implement the AddToolStripButton method.

 C#
 // This method creates a ToolStripButton and adds it to the
 // MainToolbar using the UIExtensionSites. Then it associates
 // the Click event of the button to a command.
 // UIExtensionSites are points of extension where modules can
 // add UI elements, such as items in a toolbar.
 private void AddToolStripButton(string commandName, string text)
 {
    ToolStripButton button = new ToolStripButton();
    button.Text = text;
    button.ToolTipText = text;
 
    // Add the button to the MainToolBar.
    WorkItem.UIExtensionSites[UIExtensionSiteNames.MainToolbar].Add(button);
 
    // Associate the Click event of the button to a command
    WorkItem.Commands[commandName].AddInvoker(button, "Click");
 }

3. Create a CommandHandler to handle the command you just created. This command displays a HelloWorldView on the RightWorkspace.

 C#
 // A Command Handler is used to handle the firing of a command.
  [CommandHandler(Constants.CommandNames.ShowHelloWorldMessage)]
 public void OnShowHelloWorldMessage(object sender, EventArgs e)
 {
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);
 }

4. Press F5 to build and run your Hello World application.
5. On the File menu, click Exit.

After you create your Hello World application, you can use the Smart Client Software Factory How-to topics in the documentation to extend your application in the following ways:

It can help you create a foundational module.
It can help you create a disconnected service agent.
It can help you create a Windows Presentation Foundation (WPF) view with a presenter.
It can help you map business entities to user interface elements.
It can help you publish loosely coupled events.
It can help you subscribe to loosely coupled events.
It can help you communicate between views.
It can help you translate between business entities and service entities.
It can help you deploy your application with ClickOnce.

For information about how to perform these activities, see the "Development Activities" topic in the documentation.

More Information

For access to other documentation and resources, or to provide feedback, see the Smart Client Software Factory Web site. For more general information about the goals of this and other patterns & practices deliverables, see the Microsoft patterns & practices Developer Center.

Updated Wiki: GettingStartedwiththeSmartClientSoftwareFactory2010

hanz — Fri, 21 May 2010 20:27:20 GMT

Getting Started with the Smart Client Software Factory

Are you new to the Smart Client Software Factory? The best way to get familiar with the Smart Client Software Factory is to do the following:

Build a Hello World application. For information about how to do this, see the section, Create Your Hello World Application, that follows.
Run the QuickStarts included with the software factory. The BankTeller QuickStart helps you understand the Composite UI Application Block, which is now included with the software factory. For information about the QuickStarts, see the "QuickStarts" topic in the documentation.
Download and complete the Hands-on-Labs.
Review the "Exploring the Smart Client Software Factory" topic in the documentation.

Just want to review the documentation

If you are in the evaluation phase of the factory, you can download the documentation before downloading the factory. Then when you are ready, you can download the factory.

Create Your Hello World Application

This section describes how to create and display a view using the software factory. To create your first Hello World application, perform the procedures in this section.

Note: The following procedures require the guidance package to be installed.

To create a new smart client application project

In Visual Studio 2010, point to New on the File menu, and then click Project.
In the New Project dialog box, expand Guidance Packages Project, and then select Smart Client Development May 2010.
Select the Smart Client Application (C#) Visual Studio template.
In the Name box, type HelloWorldApplication, and then click OK.
In the wizard, accept the default settings, and then click Finish.

To create a Hello World module

In Solution Explorer, right-click the solution, point to Smart Client Software Factory, and then click Add Business Module (C#).
In the Add New Project dialog box, type HelloWorldModule in the Name box.
Click OK.
In the wizard, accept the default settings, and then click Finish.

To add a Hello World view

In Solution Explorer, right-click HelloWorldModule, point to Smart Client Software Factory, and then click Add View (with presenter).
In the Add New View (with presenter) dialog box, type HelloWorldView in the View box, and then click Finish.
In Solution Explorer, double-click the file HelloWorldView.cs to view it in the Designer.* Drag a text box onto the view, and set the text to Hello World*.

To configure HelloWorldView to display on the shell's right workspace

1. In Solution Explorer, open ModuleController.cs in the HelloWorldModule project.
2. Add the following code.

C#
 using HelloWorldApplication.Infrastructure.Interface.Constants;

3. In the AddViews method, add the following code.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and show
 // the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

4. Press F5 to build and run your Hello World application.
5. On the File menu, click Exit.

Next, you will associate a command with a menu item to display the Hello World text box.

To extend your first Hello World application to use a toolbar and command

1. Comment out the following code in the AddViews method in the ModuleController.cs file so that the text box does not automatically appear.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

 C#
 // A command is an abstraction of UI elements events,
 // such as the click of a button. 
     public const string ShowHelloWorldMessage = "ShowHelloWorldMessage";

c. In Solution Explorer, under the HelloWorldModule project, double-click ModuleController.cs to open the file.
d. Add the following code to the ExtendToolStrip method.

 C#
    AddToolStripButton(Constants.CommandNames.ShowHelloWorldMessage, "Hello World");

e. Add the following code to implement the AddToolStripButton method.

 C#
 // This method creates a ToolStripButton and adds it to the
 // MainToolbar using the UIExtensionSites. Then it associates
 // the Click event of the button to a command.
 // UIExtensionSites are points of extension where modules can
 // add UI elements, such as items in a toolbar.
 private void AddToolStripButton(string commandName, string text)
 {
    ToolStripButton button = new ToolStripButton();
    button.Text = text;
    button.ToolTipText = text;
 
    // Add the button to the MainToolBar.
    WorkItem.UIExtensionSites[UIExtensionSiteNames.MainToolbar].Add(button);
 
    // Associate the Click event of the button to a command
    WorkItem.Commands[commandName].AddInvoker(button, "Click");
 }

3. Create a CommandHandler to handle the command you just created. This command displays a HelloWorldView on the RightWorkspace.

 C#
 // A Command Handler is used to handle the firing of a command.
  [CommandHandler(Constants.CommandNames.ShowHelloWorldMessage)]
 public void OnShowHelloWorldMessage(object sender, EventArgs e)
 {
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);
 }

It can help you create a foundational module.
It can help you create a disconnected service agent.
It can help you create a Windows Presentation Foundation (WPF) view with a presenter.
It can help you map business entities to user interface elements.
It can help you publish loosely coupled events.
It can help you subscribe to loosely coupled events.
It can help you communicate between views.
It can help you translate between business entities and service entities.
It can help you deploy your application with ClickOnce.

For information about how to perform these activities, see the "Development Activities" topic in the documentation.

More Information

Updated Wiki: Home

hanz — Mon, 10 May 2010 16:31:02 GMT

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 Beta that supports Visual Studio 2010 RC is now available for download.

Smart Client Software Factory 2010 Beta Source that supports Visual Studio 2010 RC is now available for download.

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

The Getting Started provides recommendations on how to quickly use the guidance available in this factory.

Click here to download the Smart Client Software Factory - April 2008 release.
Click here for detailed instructions on Installing the factory or Upgrade From Previous Releases.
Click here if you want to download only the Source Code Installer
Click here if you want to download only the Smart Client Software Factory Documentation.
Click here for a list of Known Issues.
Click here to download the Mobile Client Software Factory - July 2006 release.
Click here to go to the site of patterns & practices: Mobile Application Blocks that are currently being developed. The updated blocks are based on the Mobile Client Software Factory v1, July 2006. The update will allow developers to build mobile applications based on VS2008, .NET CF 3.5 and WM6.1.

Where to go next?

Action	Link
Read about the April 2008 release of the factory	SCSF MSDN Landing page
View recent announcements for the Smart Client program	Announcements
See a list of resources for getting started with SCSF	Learning Resources
Explore our compilation of tips, tricks and guidance from the Smart Client team and the community	SCSF Knowledge Base
Read blog postings from the team	Team Blogs
If you want to develop applications targeting mobile devices with VS2005, .NET2.0 and WM5.0, read about the Mobile Client Software Factory July 2006 release	MCSF MSDN Landing page
If you want to develop applications targeting mobile devices with VS2008, .NET3.5 and WM6.1, read about the patterns & practices: Mobile Application Blocks	patterns & practices: Mobile Application Blocks

Participation

Updated Wiki: GettingStartedwiththeSmartClientSoftwareFactory2010

hanz — Mon, 10 May 2010 16:29:59 GMT

Are you new to the Smart Client Software Factory? The best way to get familiar with the Smart Client Software Factory is to do the following:
• Build a Hello World application. For information about how to do this, see the section, "Create Your Hello World Application," that follows.
• Run the QuickStarts included with the software factory. The BankTeller QuickStart helps you understand the Composite UI Application Block, which is now included with the software factory. For information about the QuickStarts, see the "QuickStarts" topic in the documentation.
• Download and complete the Hands-on-Labs.
• Review the "Exploring the Smart Client Software Factory" topic in the documentation.

Create Your Hello World Application
This section describes how to create and display a view using the software factory. To create your first Hello World application, perform the procedures in this section.
Note: The following procedures require the guidance package to be installed.
 To create a new smart client application project
1. In Visual Studio, point to New on the File menu, and then click Project.
2. In the New Project dialog box, expand Guidance Packages Project, and then select Smart Client Development May 2010.
3. Select the Smart Client Application (C#) Visual Studio template.
4. In the Name box, type HelloWorldApplication, and then click OK.
5. In the wizard, accept the default settings and then click Finish.

 To create a Hello World module
1. In Solution Explorer, right-click the solution, point to Smart Client Software Factory, and then click Add Business Module (C#).
2. In the Add New Project dialog box, type HelloWorldModule in the Name box.
3. Click OK.
4. In the wizard, accept the default settings and then click Finish.

 To add a Hello World view
1. In Solution Explorer, right-click HelloWorldModule, point to Smart Client Software Factory, and then click Add View (with presenter).
2. In the Add New View (with presenter) dialog box, type HelloWorldView in the View box and then click Finish.
3. In Solution Explorer, double-click the file HelloWorldView.cs to view it in the Designer. Drag a text box onto the view, and set the text to Hello World.

 To configure HelloWorldView to display on the shell's right workspace
1. In Solution Explorer, open ModuleController.cs in the HelloWorldModule project.
2. Add the following code.
C#
using HelloWorldApplication.Infrastructure.Interface.Constants;
3. In the AddViews method, add the following code.
C#
// Add the HelloWorld view (smart part) to the WorkItem and show
// the view through the RightWorkspace on the shell.
HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);
4. Press F5 to build and run your Hello World application.
5. On the File menu, click Exit.

Next, you will associate a command with a menu item to display the Hello World text box.
 To extend your first Hello World application to use a toolbar and command
1. Comment out the following code in the AddViews method in the ModuleController.cs file so that the text box does not automatically appear.
C#
// Add the HelloWorld view (smart part) to the WorkItem and
// show the view through the RightWorkspace on the shell.
HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);
2. Extend the main toolbar:
a. In Solution Explorer, expand the Constants folder under the HelloWorldModule project, and then double-click CommandNames.cs to open the file.
b. Add the following code to the CommandNames class. This defines the ShowHelloWorldMessage command constant.
C#
// A command is an abstraction of UI elements events,
// such as the click of a button.
public const string ShowHelloWorldMessage = "ShowHelloWorldMessage";
c. In Solution Explorer, under the HelloWorldModule project, double-click ModuleController.cs to open the file.
d. Add the following code to the ExtendToolStrip method.
C#
AddToolStripButton(Constants.CommandNames.ShowHelloWorldMessage, "Hello World");
e. Add the following code to implement the AddToolStripButton method.
C#
// This method creates a ToolStripButton and adds it to the
// MainToolbar using the UIExtensionSites. Then it associates
// the Click event of the button to a command.
// UIExtensionSites are points of extension where modules can
// add UI elements, such as items in a toolbar.
private void AddToolStripButton(string commandName, string text)
{
ToolStripButton button = new ToolStripButton();
button.Text = text;
button.ToolTipText = text;

// Add the button to the MainToolBar.
WorkItem.UIExtensionSites[UIExtensionSiteNames.MainToolbar].Add(button);

// Associate the Click event of the button to a command
WorkItem.Commands[commandName].AddInvoker(button, "Click");
}
3. Create a CommandHandler to handle the command you just created. This command displays a HelloWorldView on the RightWorkspace.
C#
// A Command Handler is used to handle the firing of a command.
CommandHandler(Constants.CommandNames.ShowHelloWorldMessage)
public void OnShowHelloWorldMessage(object sender, EventArgs e)
{
// Add the HelloWorld view (smart part) to the WorkItem and
// show the view through the RightWorkspace on the shell.
HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);
}
4. Press F5 to build and run your Hello World application.
5. Click Hello World. The textbox will be displayed.
6. On the File menu, click Exit.

After you create your Hello World application, you can use the Smart Client Software Factory How-to topics in the documentation to extend your application in the following ways:
• It can help you create a foundational module.
• It can help you create a disconnected service agent.
• It can help you create a Windows Presentation Foundation (WPF) view with a presenter.
• It can help you map business entities to user interface elements.
• It can help you publish loosely coupled events.
• It can help you subscribe to loosely coupled events.
• It can help you communicate between views.
• It can help you translate between business entities and service entities.
• It can help you deploy your application with ClickOnce.

For information about how to perform these activities, see the "Development Activities" topic in the documentation.
More Information
For access to other documentation and resources, or to provide feedback, see the Smart Client Software Factory Web site. For more general information about the goals of this and other patterns & practices deliverables, see the Microsoft patterns & practices Developer Center.

Updated Wiki: Getting Started with the Smart Client Software Factory

hanz — Mon, 10 May 2010 16:28:39 GMT

Getting Started with the Smart Client Software Factory 2010

Getting Started with the Smart Client Software Factory

Are you new to the Smart Client Software Factory? After Installing the Smart Client Software Factory, the best way to get familiar with the Smart Client Software Factory is to do the following:

Build a Hello World application. For information about how to do this, see the section, Create Your Hello World Application, that follows.
Run the QuickStarts included with the software factory. The BankTeller QuickStart helps you understand the Composite UI Application Block, which is now included with the software factory. For information about the QuickStarts, see the "QuickStarts" topic in the documentation.
Download and complete the Hands-on-Labs.
Review the "Exploring the Smart Client Software Factory" topic in the documentation.

Just want to review the documentation

If you are in the evaluation phase of the factory, you can download the documentation before downloading the factory. Then when you are ready, you can download the factory.

Create Your Hello World Application

This section describes how to create and display a view using the software factory. To create your first Hello World application, perform the procedures in this section.

Note: The following procedures require the guidance package to be installed.

To create a new smart client application project

In Visual Studio 2008, point to New on the File menu, and then click Project.
In the New Project dialog box, expand Guidance Packages Project, and then select Smart Client Development - April 2008.
Select the Smart Client Application (C#) Visual Studio template.
In the Name box, type HelloWorldApplication, and then click OK.
In the wizard, accept the default settings, select the Show documentation after recipe completes check box, and then click Finish.

To create a Hello World module

In Solution Explorer, right-click the solution, point to Smart Client Software Factory, and then click Add Business Module (C#).
In the Add New Project dialog box, type HelloWorldModule in the Name box.
Click OK.
In the wizard, accept the default settings, select the Show documentation after recipe completes check box, and then click Finish.

To add a Hello World view

In Solution Explorer, right-click HelloWorldModule, point to Smart Client Software Factory, and then click Add View (with presenter).
In the Add New View (with presenter) dialog box, type HelloWorldView in the View box, select the Show documentation after recipe completes check box, and then click Finish.
In Solution Explorer, double-click the file HelloWorldView.cs to view it in the Designer.* Drag a text box onto the view, and set the text to Hello World*.

To configure HelloWorldView to display on the shell's right workspace

1. In Solution Explorer, open ModuleController.cs in the HelloWorldModule project.
2. Add the following code.

C#
 using HelloWorldApplication.Infrastructure.Interface.Constants;

3. In the AddViews method, add the following code.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and show
 // the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

4. Press F5 to build and run your Hello World application.
5. On the File menu, click Exit.

Next, you will associate a command with a menu item to display the Hello World text box.

To extend your first Hello World application to use a toolbar and command

1. Comment out the following code in the AddViews method in the ModuleController.cs file so that the text box does not automatically appear.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

 C#
 // A command is an abstraction of UI elements events,
 // such as the click of a button. 
     public const string ShowHelloWorldMessage = "ShowHelloWorldMessage";

c. In Solution Explorer, under the HelloWorldModule project, double-click ModuleController.cs to open the file.
d. Add the following code to the ExtendToolStrip method.

 C#
    AddToolStripButton(Constants.CommandNames.ShowHelloWorldMessage, "Hello World");

e. Add the following code to implement the AddToolStripButton method.

 C#
 // This method creates a ToolStripButton and adds it to the
 // MainToolbar using the UIExtensionSites. Then it associates
 // the Click event of the button to a command.
 // UIExtensionSites are points of extension where modules can
 // add UI elements, such as items in a toolbar.
 private void AddToolStripButton(string commandName, string text)
 {
    ToolStripButton button = new ToolStripButton();
    button.Text = text;
    button.ToolTipText = text;
 
    // Add the button to the MainToolBar.
    WorkItem.UIExtensionSites[UIExtensionSiteNames.MainToolbar].Add(button);
 
    // Associate the Click event of the button to a command
    WorkItem.Commands[commandName].AddInvoker(button, "Click");
 }

3. Create a CommandHandler to handle the command you just created. This command displays a HelloWorldView on the RightWorkspace.

 C#
 // A Command Handler is used to handle the firing of a command.
  [CommandHandler(Constants.CommandNames.ShowHelloWorldMessage)]
 public void OnShowHelloWorldMessage(object sender, EventArgs e)
 {
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);
 }

It can help you create a foundational module.
It can help you create a disconnected service agent.
It can help you create a Windows Presentation Foundation (WPF) view with a presenter.
It can help you map business entities to user interface elements.
It can help you publish loosely coupled events.
It can help you subscribe to loosely coupled events.
It can help you communicate between views.
It can help you translate between business entities and service entities.
It can help you deploy your application with ClickOnce.

For information about how to perform these activities, see the "Development Activities" topic in the documentation.

More Information

Updated Wiki: Getting Started with the Smart Client Software Factory

hanz — Mon, 10 May 2010 16:28:26 GMT

The Getting Started with the Smart Client Software Factory 2010

Getting Started with the Smart Client Software Factory

Are you new to the Smart Client Software Factory? After Installing the Smart Client Software Factory, the best way to get familiar with the Smart Client Software Factory is to do the following:

Build a Hello World application. For information about how to do this, see the section, Create Your Hello World Application, that follows.
Run the QuickStarts included with the software factory. The BankTeller QuickStart helps you understand the Composite UI Application Block, which is now included with the software factory. For information about the QuickStarts, see the "QuickStarts" topic in the documentation.
Download and complete the Hands-on-Labs.
Review the "Exploring the Smart Client Software Factory" topic in the documentation.

Just want to review the documentation

If you are in the evaluation phase of the factory, you can download the documentation before downloading the factory. Then when you are ready, you can download the factory.

Create Your Hello World Application

This section describes how to create and display a view using the software factory. To create your first Hello World application, perform the procedures in this section.

Note: The following procedures require the guidance package to be installed.

To create a new smart client application project

In Visual Studio 2008, point to New on the File menu, and then click Project.
In the New Project dialog box, expand Guidance Packages Project, and then select Smart Client Development - April 2008.
Select the Smart Client Application (C#) Visual Studio template.
In the Name box, type HelloWorldApplication, and then click OK.
In the wizard, accept the default settings, select the Show documentation after recipe completes check box, and then click Finish.

To create a Hello World module

In Solution Explorer, right-click the solution, point to Smart Client Software Factory, and then click Add Business Module (C#).
In the Add New Project dialog box, type HelloWorldModule in the Name box.
Click OK.
In the wizard, accept the default settings, select the Show documentation after recipe completes check box, and then click Finish.

To add a Hello World view

In Solution Explorer, right-click HelloWorldModule, point to Smart Client Software Factory, and then click Add View (with presenter).
In the Add New View (with presenter) dialog box, type HelloWorldView in the View box, select the Show documentation after recipe completes check box, and then click Finish.
In Solution Explorer, double-click the file HelloWorldView.cs to view it in the Designer.* Drag a text box onto the view, and set the text to Hello World*.

To configure HelloWorldView to display on the shell's right workspace

1. In Solution Explorer, open ModuleController.cs in the HelloWorldModule project.
2. Add the following code.

C#
 using HelloWorldApplication.Infrastructure.Interface.Constants;

3. In the AddViews method, add the following code.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and show
 // the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

4. Press F5 to build and run your Hello World application.
5. On the File menu, click Exit.

Next, you will associate a command with a menu item to display the Hello World text box.

To extend your first Hello World application to use a toolbar and command

1. Comment out the following code in the AddViews method in the ModuleController.cs file so that the text box does not automatically appear.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

 C#
 // A command is an abstraction of UI elements events,
 // such as the click of a button. 
     public const string ShowHelloWorldMessage = "ShowHelloWorldMessage";

c. In Solution Explorer, under the HelloWorldModule project, double-click ModuleController.cs to open the file.
d. Add the following code to the ExtendToolStrip method.

 C#
    AddToolStripButton(Constants.CommandNames.ShowHelloWorldMessage, "Hello World");

e. Add the following code to implement the AddToolStripButton method.

 C#
 // This method creates a ToolStripButton and adds it to the
 // MainToolbar using the UIExtensionSites. Then it associates
 // the Click event of the button to a command.
 // UIExtensionSites are points of extension where modules can
 // add UI elements, such as items in a toolbar.
 private void AddToolStripButton(string commandName, string text)
 {
    ToolStripButton button = new ToolStripButton();
    button.Text = text;
    button.ToolTipText = text;
 
    // Add the button to the MainToolBar.
    WorkItem.UIExtensionSites[UIExtensionSiteNames.MainToolbar].Add(button);
 
    // Associate the Click event of the button to a command
    WorkItem.Commands[commandName].AddInvoker(button, "Click");
 }

3. Create a CommandHandler to handle the command you just created. This command displays a HelloWorldView on the RightWorkspace.

 C#
 // A Command Handler is used to handle the firing of a command.
  [CommandHandler(Constants.CommandNames.ShowHelloWorldMessage)]
 public void OnShowHelloWorldMessage(object sender, EventArgs e)
 {
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);
 }

It can help you create a foundational module.
It can help you create a disconnected service agent.
It can help you create a Windows Presentation Foundation (WPF) view with a presenter.
It can help you map business entities to user interface elements.
It can help you publish loosely coupled events.
It can help you subscribe to loosely coupled events.
It can help you communicate between views.
It can help you translate between business entities and service entities.
It can help you deploy your application with ClickOnce.

For information about how to perform these activities, see the "Development Activities" topic in the documentation.

More Information

Updated Wiki: Getting Started with the Smart Client Software Factory

hanz — Mon, 10 May 2010 16:27:48 GMT

!Getting Started with the Smart Client Software Factory 2010

Getting Started with the Smart Client Software Factory

Are you new to the Smart Client Software Factory? After Installing the Smart Client Software Factory, the best way to get familiar with the Smart Client Software Factory is to do the following:

Build a Hello World application. For information about how to do this, see the section, Create Your Hello World Application, that follows.
Run the QuickStarts included with the software factory. The BankTeller QuickStart helps you understand the Composite UI Application Block, which is now included with the software factory. For information about the QuickStarts, see the "QuickStarts" topic in the documentation.
Download and complete the Hands-on-Labs.
Review the "Exploring the Smart Client Software Factory" topic in the documentation.

Just want to review the documentation

If you are in the evaluation phase of the factory, you can download the documentation before downloading the factory. Then when you are ready, you can download the factory.

Create Your Hello World Application

This section describes how to create and display a view using the software factory. To create your first Hello World application, perform the procedures in this section.

Note: The following procedures require the guidance package to be installed.

To create a new smart client application project

In Visual Studio 2008, point to New on the File menu, and then click Project.
In the New Project dialog box, expand Guidance Packages Project, and then select Smart Client Development - April 2008.
Select the Smart Client Application (C#) Visual Studio template.
In the Name box, type HelloWorldApplication, and then click OK.
In the wizard, accept the default settings, select the Show documentation after recipe completes check box, and then click Finish.

To create a Hello World module

In Solution Explorer, right-click the solution, point to Smart Client Software Factory, and then click Add Business Module (C#).
In the Add New Project dialog box, type HelloWorldModule in the Name box.
Click OK.
In the wizard, accept the default settings, select the Show documentation after recipe completes check box, and then click Finish.

To add a Hello World view

In Solution Explorer, right-click HelloWorldModule, point to Smart Client Software Factory, and then click Add View (with presenter).
In the Add New View (with presenter) dialog box, type HelloWorldView in the View box, select the Show documentation after recipe completes check box, and then click Finish.
In Solution Explorer, double-click the file HelloWorldView.cs to view it in the Designer.* Drag a text box onto the view, and set the text to Hello World*.

To configure HelloWorldView to display on the shell's right workspace

1. In Solution Explorer, open ModuleController.cs in the HelloWorldModule project.
2. Add the following code.

C#
 using HelloWorldApplication.Infrastructure.Interface.Constants;

3. In the AddViews method, add the following code.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and show
 // the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

4. Press F5 to build and run your Hello World application.
5. On the File menu, click Exit.

Next, you will associate a command with a menu item to display the Hello World text box.

To extend your first Hello World application to use a toolbar and command

1. Comment out the following code in the AddViews method in the ModuleController.cs file so that the text box does not automatically appear.

 C#
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);

 C#
 // A command is an abstraction of UI elements events,
 // such as the click of a button. 
     public const string ShowHelloWorldMessage = "ShowHelloWorldMessage";

c. In Solution Explorer, under the HelloWorldModule project, double-click ModuleController.cs to open the file.
d. Add the following code to the ExtendToolStrip method.

 C#
    AddToolStripButton(Constants.CommandNames.ShowHelloWorldMessage, "Hello World");

e. Add the following code to implement the AddToolStripButton method.

 C#
 // This method creates a ToolStripButton and adds it to the
 // MainToolbar using the UIExtensionSites. Then it associates
 // the Click event of the button to a command.
 // UIExtensionSites are points of extension where modules can
 // add UI elements, such as items in a toolbar.
 private void AddToolStripButton(string commandName, string text)
 {
    ToolStripButton button = new ToolStripButton();
    button.Text = text;
    button.ToolTipText = text;
 
    // Add the button to the MainToolBar.
    WorkItem.UIExtensionSites[UIExtensionSiteNames.MainToolbar].Add(button);
 
    // Associate the Click event of the button to a command
    WorkItem.Commands[commandName].AddInvoker(button, "Click");
 }

3. Create a CommandHandler to handle the command you just created. This command displays a HelloWorldView on the RightWorkspace.

 C#
 // A Command Handler is used to handle the firing of a command.
  [CommandHandler(Constants.CommandNames.ShowHelloWorldMessage)]
 public void OnShowHelloWorldMessage(object sender, EventArgs e)
 {
 // Add the HelloWorld view (smart part) to the WorkItem and
 // show the view through the RightWorkspace on the shell.
 HelloWorldView hwview = ShowViewInWorkspace< HelloWorldView >(WorkspaceNames.RightWorkspace);
 }

It can help you create a foundational module.
It can help you create a disconnected service agent.
It can help you create a Windows Presentation Foundation (WPF) view with a presenter.
It can help you map business entities to user interface elements.
It can help you publish loosely coupled events.
It can help you subscribe to loosely coupled events.
It can help you communicate between views.
It can help you translate between business entities and service entities.
It can help you deploy your application with ClickOnce.

For information about how to perform these activities, see the "Development Activities" topic in the documentation.

smartclient Wiki & Documentation Rss Feed

New Comment on "Commands and Events"

New Comment on "Hands-On-Labs"

New Comment on "GettingStartedwiththeSmartClientSoftwareFactory2010"

New Comment on "Getting Started with the Smart Client Software Factory"

Updated Wiki: Known Issues / Fixes

Known Issues / Fixes

Updated Wiki: Known Issues / Fixes

Known Issues / Fixes

Updated Wiki: SCSF Knowledge Base

Smart Client Software Factory Knowledge Base

Categories:

New posts:

Updated Wiki: New posts

New Posts

Updated Wiki: Home

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Documentation is now available for download.

Smart Client Software Factory 2010 Getting Started Guide is now available

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

Where to go next?

Participation

Updated Wiki: Home

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Documentation is now available for download.

Smart Client Software Factory 2010 Getting Started Guide is now available

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

Where to go next?

Participation

Updated Wiki: Home

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Documentation is now available for download.

Smart Client Software Factory 2010 Getting Started Guide

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

Where to go next?

Participation

Updated Wiki: Home

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 is now available for download.

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

Where to go next?

Participation

Updated Wiki: Home

Welcome to patterns & practices Smart Client Guidance Community site.

Smart Client Software Factory 2010 that supports Visual Studio 2010 RC is now available for download.

Smart Client Software Factory 2010 Source that supports Visual Studio 2010 RC is now available for download.

Smart Client Software Factory - April 2008 Release that supports Visual Studio 2008 is now available.

Getting Started

Where to go next?

Participation

Updated Wiki: GettingStartedwiththeSmartClientSoftwareFactory2010

Getting Started with the Smart Client Software Factory 2010

Just want to review the documentation

Create Your Hello World Application

To create a new smart client application project

To create a Hello World module

To add a Hello World view

To configure HelloWorldView to display on the shell's right workspace

To extend your first Hello World application to use a toolbar and command

More Information

Updated Wiki: GettingStartedwiththeSmartClientSoftwareFactory2010

Getting Started with the Smart Client Software Factory

Just want to review the documentation

Create Your Hello World Application

To create a new smart client application project

To create a Hello World module

To add a Hello World view

To configure HelloWorldView to display on the shell's right workspace

To extend your first Hello World application to use a toolbar and command