Windows 7 Product Key Programming with the Microso

[henane123]

Mark Bukovec
Empire Down DevelopmentSeptember 2003Applies to:
Microsoft(R) Workplace Visio(R) 2003Summary: Learn how to integrate the Microsoft(R) Office Visio(R) 2003 ActiveX(R) Handle, also referred to as the Visio drawing control, into programs. Critique perfect practices and how to use the Visio drawing handle programmatically. (24 printed pages)Contents Introduction Understanding the Visio Drawing Command Scenarios for Implementing the Visio Drawing Control Style and design Preferred Practices Obtaining Started out Integrating the Command along with the Host Container Deployment ConclusionIntroduction The Microsoft(R) Office Visio(R) 2003 ActiveX(R) Management (Visio drawing command) presents the full functionality from the Visio software with the rich Visio object product, as an embeddable component. You're able to drive the Visio drawing manage programmatically by occasions or by code with your hosting application. Alternatively, the Visio drawing manage can offer a diagramming atmosphere for software consumers inside the context of your respective very own application's person interface (UI). In this particular guide, you will definitely find out: The elements on the Visio drawing management and example use situations. Perfect practices for employing the Visio drawing handle in Visio answers. Methods to embed the Visio drawing management in a very range of host applications, which includes Microsoft Windows(R) Forms, Microsoft Visual Primary(R) six.0 kinds, Microsoft Office paperwork, and Microsoft Online Explorer. The best way to utilize the properties of the Visio drawing handle API. How to load Visio paperwork to the drawing manage window and conserve alterations. Ways to obtain a reference on the Visio Application object in order to deliver the results programmatically with all the Visio document. The best way to manage the screen on the drawing surface. Easy methods to integrate the control with your host application user interface. How you can deploy the Visio drawing control together with your application. Knowledge the Visio Drawing Command The Visio drawing manage delivers the functionality in the Visio application object model within a part. The Visio drawing management are usually embedded in host programs developed working with Microsoft Visual Studio(R) .NET 2003, Microsoft Workplace XP and Microsoft Office 2003 containers for example Microsoft Workplace Word 2003, Microsoft Web-based Explorer 5.0 and later on, as well as other Microsoft ActiveX(R) handle containers. After added, the Visio drawing handle allows for a drawing surface for exhibiting styles.The Visio drawing control helps the developer to provide Visio features in the context of a further application. This new degree of integration lets the developer full manage more than the Visio person interface integration with all the host software. The new features will provide further electrical power than simply simply embedding a Visio drawing into an OLE container document, like Phrase. Working with a Visio drawing as an OLE object enables you to see the diagram inside container application, link the OLE object for the actual Visio document to reflect modifications, and edit the Visio drawing by activating the Visio application from within the container document.Inside situation of in-place OLE activation, that you're however working within the Visio consumer interface. You can not make your own UI. You can't programmatically entry the Visio document employing Automation from your that contains software. That you're also constrained to software hosts that apply an OLE container, which guidelines out technologies that include .NET Windows Types. The Visio drawing management, nonetheless, offers new functionality to handle these situations, and means that you can create new Visio answers that weren't earlier doable, for example those described inside subsequent area of this article, "Scenarios for Employing the Visio Drawing Handle."The Visio drawing management is distributed with the Visio product or service setup. There may be also a primary interop assembly available for managed-code access to the Visio drawing command API. If you want to use the handle from managed code, you will need to set up the Visio key interop assemblies. See the Deployment area of this short article for information on putting in the Visio drawing control plus the Visio key interop assemblies.Situations for Using the Visio Drawing Handle To show the utility from the Visio drawing management, have a look at the following consumer situations. A company's services division presents an office space-planning application for administrative assistants. A Windows Sort hosts the drawing control, which displays an area representing the layout for the office. Up coming towards the drawing manage are buttons representing workplace furniture. Once the administrative assistant clicks a button, a shape is dropped on the drawing form, which he can then reposition within the drawing control to find out how the furnishings arrangement seems to be within the office. The Windows Kind contains an celebration handler, published in Visual Common .NET, which responds to a new form currently being additional and tracks the furnishings selections to generate a obtain purchase. The administrative assistant can rearrange and eliminate the furnishings selections by deleting styles with the drawing command. Since the administrative assistant is driving the drawing surface in the form's UI, the person does not have to become familiar using the Visio application. A management crew is working on a flowchart to map out worker processes. To help collaboration, the crew employs Microsoft Office SharePointTM Portal Server, which gives a central storage level for crew documentation and instruments for collaborating and sharing documents. The managers aren't familiar with drawing equipment and would desire to enter system basic steps inside of a Microsoft Workplace Excel spreadsheet and also have Visio produce the flowchart drawing from that information. Also,Office Pro Plus 2007 Key, they'd want to see all their information to the exact browser page. To implement these needs, the software developer modifies the staff page about the SharePoint page by incorporating a info sheet Internet Portion that displays the Excel spreadsheet for defining the process steps. Then the developer generates a customized Web site Portion that hosts the drawing manage. The developer links the two Internet Areas jointly as well as a flowchart is immediately created inside of the drawing control from your technique step knowledge in Excel. If a supervisor wants to modify the flowchart, she edits a row within the information sheet World wide web Element, and also flowchart designs are refreshed to reflect the modifications. This method allows the managers to perform all their updates within the exact browser page and operate along with the equipment they're most snug implementing.
The management helps you to make event-driven programs much like the ones just described making use of a range of host containers. Instead than building up a solution that may be hosted with the Visio application consumer interface, you can actually add the drawing surface element to your current or planned application. From the situation from the Visio drawing control, the application usually reflects the architecture demonstrated in Figure one.Figure one. Application hosting the Visio drawing controlUsing the Visio drawing management in your software allows for the following benefits: The Visio drawing management runs in-process with your software and won't call for a separate instance in the Visio software to be operating. The control displays just one Visio document and single window per instance. You're able to show numerous paperwork by embedding multiple control occasions inside the host software. The Visio drawing manage also exposes a procedure for loading an present Visio file. The manage will allow for user interface integration with all the host software. Developers can offer a simplified user interface for end users unfamiliar with Visio. The host application can accessibility Visio Automation properties and ways with the embedded control instance. This enables the host application to programmatically modify the contained Visio document. The handle right exposes Visio Window and Document events. It's also possible to cultivate a Visio drawing command method employing managed code. Managed code interoperability is offered through the Visio primary interop assemblies, which offer managed-code access for the Visio drawing command API as well as Visio Automation library. Just before the drawing management, for managed code you may only create a COM add-in or executable by using a managed language. Using the management, you’re able to execute Visio Automation code immediately in the application. This integration means that you can use Windows Kinds as an application container and code in managed languages including Visual Studio C++, Visual.NET C# or Visual Elementary .NET.Layout Greatest Practices Because the Visio drawing handle can be described as programmable element, you’re able to integrate your Visio choice code straight to the host container application. In prior releases of Visio, a developer writing a solution for your Visio consumer software required to bundle the remedy code inside a COM add-in, Visio treatment library (VSL), out-of-process executable, or inside of a Visual Primary for Applications (VBA) challenge in the document. The Visio handle simplifies method architecture as well as development method by enabling programming of the Visio Software object through the hosting software. A developer making use of the manage in a very custom software (for example a C# software) or World wide web Explorer ought to plan in opposition to the Visio object model right inside host application, with no separating the Visio logic into a COM add-in, VSL, or executable. Calling a Visio COM add-in, VSL, or executable through the hosting application unnecessarily complicates the debugging for the Visio integration. In spite of this, once you would like to host the Visio control inside a Microsoft Office Technique application besides Visio, you will have to make use of a COM add-in. During this scenario, construct a COM add-in in your host software in lieu of for Visio. For instance, in the event you approach to host your Visio management in a Microsoft Office Phrase 2003 document, build a Phrase COM add-in and accessibility the Visio control through the Word add-in. Make certain your COM add-in is targeted with the host due to the fact an Workplace host software will not likely load a Visio COM add-in for your drawing handle.Working with Handle Host Limitations The Visio drawing management supports quite a few containers, such as hosting applications built in Visual Studio. NET 2003, Visual Studio six.0, Web-based Explorer five.0 or later, ASP.NET, along with other ActiveX manage containers. Having said that, the Visio manage can not be immediately embedded in: A further ActiveX control, like the Net Explorer browser manage. A Visio document. A Microsoft Workplace InfoPathTM 2003 sort. Note You can embed ActiveX controls to the Visio drawing control (rather than the Visio drawing manage embedded in a second ActiveX command). However, because the Visio drawing management will not execute VBA code in the Visio document, it is really more beneficial to integrate other ActiveX controls to the host software undertaking as a substitute for the Visio document. Working with the Visio Handle along with the Web Explorer Browser Handle While you can not embed the Visio drawing command straight into one additional ActiveX handle, it is easy to nonetheless utilize the Visio drawing control with programs that rely using the web Explorer browser command. World-wide-web Explorer 5.0 or later on supplies a superb host container for that Visio drawing manage,Windows 7 Product Key, permitting developers to create script against the Visio object model in Microsoft Visual Fundamental Scripting Edition (VBScript) or ECMAScript as defined from the specification of the European Pc Makers Association, which include JScript or JavaScript. To integrate the Visio drawing control with an internet Explorer browser control-based application, like the Microsoft Office Task Web site Access client, do the subsequent: Add a hyperlink in your Web Explorer browser management that launches a new World wide web Explorer practice with its very own window. Embed the Visio drawing control while in the new On-line Explorer window for the new Online world Explorer procedure. Plan versus the Visio drawing management implementing your favored scripting language. Applying the Visio Manage with Microsoft Office InfoPath 2003 Whilst you cannot embed the Visio drawing management specifically onto an InfoPath 2003 form, InfoPath gives you a solution project pane made up of a web Explorer window. You can embed the Visio drawing control instantly into the InfoPath treatment activity pane window and use the Document Object Product (DOM) to share data in between the Visio drawing as well as InfoPath sort.Comprehension the Visio Drawing Control's SDI When developing an application that uses the Visio drawing management, it really is valuable to grasp the Visio manage supports just one document within a single window. The control's single document interface (SDI) architecture results in the following things to consider when developing the Visio drawing manage integration with your software: Use various circumstances from the Visio drawing command to exhibit multiple Visio documents in your own software. Unlike the Visio client software, which may show various documents and windows at a time, the Visio drawing management can only exhibit a single document per instance of the control. If your developer wants to show many different Visio documents, the developer can embed numerous circumstances for the management inside the application, with each and every instance loading a separate Visio document. Really don't count on VBA for programming logic. VBA is not really integrated together with the Visio drawing handle. As a end result, documents loaded within the Visio drawing manage never execute any VBA code associated with all the document. The control's lack of a VBA run-time atmosphere prevents the distribution of legit code or malicious macros by means of documents loaded through the Visio management. It also usually means the consumer of an application hosting the handle will do not ever see the Visio application's security dialog box warning about macros while in the document. Make use of the Visio ShapeSheet(R) programmatically. The management won't give entry on the Visio ShapeSheet user interface, and that is a separate window during the Visio software. In spite of this, the ShapeSheet by itself still exists for the Visio styles and pages from the document loaded during the Visio drawing control. You'll be able to however edit ShapeSheet cells to your Visio document within the command using Visio Automation. For instance, it is easy to use the Cell object's SRC house to add a double-click action for the Visio shape. Be aware Whenever you are programming the ShapeSheet for paperwork loaded inside the command, you will not have the ability to implement the CALLTHIS perform, which calls a VBA macro inside document. The Visio drawing manage doesn't execute VBA code, so any utilization of the CALLTHIS operate fails silently. As an alternative, you could use the mouse occasions for that Visio Page and Document objects and manage the event response in your customized container application logic. (For more advice about mouse events, see Dealing with Events.) If you should are working with a COM add-in, it's also possible to utilize the QUEUEMARKER operate to queue a marker celebration on the double-click event in the ShapeSheet. Porting Present Visio Answers After you are porting your code from an present Visio customer software treatment to your Visio manage, consist of these style and design factors in the considering. Port VBA code. You will need to port all existing VBA code right into a COM add-in, or even more ideally, your host application. You could retain most of your exact algorithms and logic, so long as it is sensible functioning inside the control's SDI architecture. Port an current Visio method COM add-in, executable, or VSL to the container application. Whilst it could possibly be initially much easier to just use an existing COM add-in, executable, or VSL using the host application, it is actually endorsed that you just integrate the Visio drawing control programming specifically with all the host software. By taking the time to port your code out of your current choice for your host application, you may simplify deployment of your respective method, and streamline the progress, debugging, and maintenance technique over time. You don't ought to use a COM add-in unless you will be working with the management in an additional Workplace container. Re-evaluate information storage in designs. If your current Visio method merchants in depth data in shapes, give consideration to re-architecting info storage out of Visio shapes and into info structures maintained or accessed by the host application. Visio can retailer as a good deal data while you might need, but it regularly can make significantly more feeling to help keep Visio as being a presentation layer part and use your host software as info storage or access to a data supply. In the event the information is comparatively static,Microsoft Office Professional 2010, although, and employed heavily for modifying the appearance and layout of styles, it would make a lot more sense to shop the information during the form customized properties. Contemplate celebration integration with the host application. Not like a Visio client application choice, the Visio drawing surface can react to the two person events and host application events. Give some thought to how you want the drawing surface to respond to events fired through the host software, and the way your host software wants to reply to occasions inside the Visio drawing surface. Use marker events for COM add-ins. If you have got to use a COM add-in, you will need a way to notify your COM add-in to reply to a person action in the document. Use the QUEUEMARKER perform with the ShapeSheet or even a persistent occasion using the document to queue a marker occasion to which your COM add-in responds. Commencing New Visio Growth If you are just starting Visio integration with an software, it can be most desirable to program straight versus the Visio object model inside your host software code. Furthermore towards the design recommendation and implementation pointers within this document, seek the advice of these sources for material on utilising the Visio object product: Microsoft Office Visio Automation Reference Allows for technical documentation on the Visio object model. Microsoft Office Visio ShapeSheet Reference Gives you technical documentation on ShapeSheet cells and capabilities which you can program through the Visio object product. Visio Developer Middle on MSDN Allows for content articles, tutorials, in addition to a computer software advancement kit (SDK) for Visio developers of all amounts. Receiving Started out This segment addresses the essential steps for by using the Visio drawing handle inside your application. It describes the way to embed the handle within a host container, tips on how to load Visio documents into the command window and save changes, and the way to get a reference on the Visio Application object in order that you may labor programmatically together with the Visio document.Developing a Visio Drawing Management Instance This segment particulars the techniques for developing Visio drawing handle instances and setting references for your subsequent containers: Windows Sorts, Visual Primary six.0 form-based applications, Office documents, and Online Explorer.Notice A developer cannot activate a Visio drawing in the Visio management at design and style time. Visio drawings within the handle activate at run time only. Establishing a Visio Drawing Control Instance in Managed Code You are able to without difficulty set up a Visio drawing control instance in managed code.Finishing this process to add the subsequent assembly references for your project: VisioOcx The Visio drawing management major interop assembly. Visio The Visio choice library major interop assembly. AxVisOcx An ActiveX handle wrapper assembly that allows the handle to become embedded within just a Windows Sort. The Windows Forms ActiveX Management Importer (Aximp.exe) generates this assembly immediately and adds it to your task. This wrapper assembly have got to be redistributed with the software. Many different Visio drawing control situations on the form share similar wrapper class derived from the AxHost course. To add the Visio drawing management to a Windows Sort In Visual Studio .NET, screen the Windows Sort in Style and design mode. Click the Toolbox. Right-click within the Toolbox and determine Add/Remove Things to open the Customize Toolbox dialog box. Click on the COM Parts tab within the Customize Toolbox dialog box. Find Microsoft Visio Drawing Manage for that style library, as demonstrated in Figure 2.

Figure two. Including the Visio drawing management for the Visual Studio .NET Toolbox Click on Ok. The Visio drawing manage is now attainable with the Toolbox, as shown in Figure 3.

Figure 3. Visio drawing management inside Visual Studio .NET Toolbox Add the Visio drawing handle to the kind either by double-clicking it within the Toolbox or by clicking it then dragging it towards the sort. Developing a Visio Drawing Command Instance in Visual Important six.0 You could very easily generate a Visio drawing control instance making use of Visual Important six.0. Finishing this process to add a reference for the Visio drawing manage sort library. If you would like to programmatically adjust the Visio document contained while in the drawing command instance, you will need to add a reference to your Microsoft Visio eleven.0 Variety Library.To add the Visio drawing control to a Visual Elementary six.0 form In Visual Important six.0, display the type in Layout mode, right-click the Toolbox, and after that opt for Parts. Around the Controls tab within the Parts dialog box, decide upon Microsoft Visio Drawing Handle 11.0, as proven in Figure four.

Figure 4. Including the Visio drawing manage on the Visual Common six.0 Toolbox Click Ok. The Visio drawing command is now attainable within the Toolbox.

Figure five. The Visio drawing command inside the Visual Simple six.0 Toolbox Add the Visio drawing to the form either by double-clicking it in the Toolbox or by clicking it and after that dragging it on the sort. Generating a Visio Drawing Control Instance in Microsoft Workplace System Software Document Completing this method to add a reference for the Visio drawing command style library. If you'd like to programmatically change the Visio document contained from the drawing handle instance, you'll need to add a reference towards the Microsoft Visio 11.0 Choice Library.To add the Visio drawing control to an Office application document Right-click the Office application's toolbar and decide on Command Toolbox. On the Manage Toolbox toolbar, click on the Extra Controls button, and after that pick out Microsoft Visio Drawing Management, as shown in Figure 6:

Figure 6. Adding the Visio drawing management to your Microsoft Workplace Word Toolbox Following inserting the Visio drawing handle into an Workplace software document, you're able to see its properties by right-clicking it and choosing Properties. If you would like to accessibility the Visio drawing command programmatically from your document's Visual Elementary venture, right-click the command and decide on View Code.Producing a Visio Drawing Control Instance in Word wide web Explorer To add the Visio drawing control to a Internet Kind or an HTML page, you will definitely abide by the procedure in Designing a Visio Drawing Handle Instance in Managed Code, except that you'll drag the Visio drawing handle for your Internet page rather than to a Windows Form. Visual Studio .NET adds the subsequent HTML on the Web page:Modifying the values in the Properties window updates the house tags for your Visio drawing management instance. By way of example, for those who modify the Src house, Visual Studio .NET generates a tag similar to the subsequent:The Visio drawing manage is hosted as a client-side object and supports a constrained quantity of properties for scripting languages which include VBScript. You’re able to script alterations to the properties exposed by the Visio drawing manage. However, you can't accessibility the Visio object model utilizing a scripting language, meaning you will not have the ability to programmatically modify the Visio document displayed through the management. The user could make modifications on the Visio document by clicking the drawing surface.Be aware The handle will only initialize during the to begin with thread of any provided Online Explorer system. For those who want to use many situations for the handle in an internet Explorer-based software, generate a brand new Net Explorer technique for each supplemental instance of your management and load the HTML page that contains the control inside new Online Explorer method. Obtaining a Reference to the Visio Application Object You're able to access the Visio object design with the Visio drawing control's API. To obtain a reference to the Visio Software object, use either the drawing control's Document or Window residence.Such as, the following C# code shows how to get a reference to your Visio Application object by using the drawing control's Window property:You're able to do precisely the same thing working with the following Visual Basic six.0 code:Managing Documents When the Visio drawing control is loaded, it displays a blank Visio drawing. If you need to display an current Visio document, the drawing command exposes an Src residence for loading a document into the control. You may then utilize the document's SaveAs technique to help save any adjustments.Loading a Visio Document Use the Visio drawing control's Src home to load a document into the management. By way of example, the following C# instance displays how to load a Visio drawing:You’re able to load any Visio file sort applying the Src residence (for example, .vsd, .vdx, .vst, or .svg). The file may be saved locally or on the remote file server.The Visio control's Src house loads a copy for the file specified during the Src value. To persist the modifications with the control's document, you need to help save the Visio document implementing the SaveAs strategy. Alternatively, you can actually persist variations in-stream. In equally circumstances, nevertheless, you do not modify the initial document loaded from the Src home.Saving a Visio Document to File The control loads a copy in the file specified by the SRC residence. The file loaded thru SRC is simply not opened for read/write operations, and therefore won't be able to be saved working with the Conserve procedure. To save alterations to your document loaded inside Visio drawing control, get in touch with the document's SaveAs methodology. The following C# instance shows how you can utilize the drawing control Document residence to phone the SaveAs strategy:You cannot make use of the SaveA###### approach to help save Visio 2003 paperwork to Visio 2002 format inside Visio ActiveX manage. To save a drawing loaded from the Visio drawing control to Visio 2002 format, start an invisible instance of Visio and phone the SaveA###### process in the Visio software instance, as demonstrated on this Visual Elementary six.0 code that saves a Visio 2003 drawing to the Visio 2003 file format:Conserving a Visio Document inside Command to Stream Developers might possibly prefer to persist variations to a drawing with the Visio drawing command with out conserving the drawing to disk. For example, if a consumer modifies a Visio document in an embedded control in a very Word document, the alterations are lost once the user forwards that Word document in an e-mail message. When one additional user opens the document, the manage loads the file specified from the Src property, overwriting any modifications. To persist modifications in-stream to a Visio document while in the manage Load the initial document working with the Visio control's Src property. Just after the document loads, set the Src property to an empty string. When the handle is activated in its container document after the primary initialization, the control displays the previous in-stream picture rather than the original document specified by the Src home.Implementing Blank Documents inside the Handle To load a blank drawing while in the handle when the manage is initialized for your very first time, set the Src property to an empty string. Still, if you need to emulate setting up a fresh blank drawing during the handle soon after loading an present drawing document, you've gotten 3 choices: Decide on all and delete all shapes during the drawings. This method allows for the developer to preserve any existing kinds from the presently loaded document. Load a brand new, blank document employing the Src house. Dynamically ruin and reinitialize the Visio drawing handle with the document. Integrating the Control with the Host Container You can modify the physical appearance for the Visio drawing handle in the application. By default, all Visio toolbars are turned off and also the stencil pane isn't really shown. You'll be able to find how the drawing command surface seems by exhibiting scroll bars, rulers, or by changing the window track record coloration. The drawing control exposes a PageSizingBehavior home that determines how the page is shown in the drawing command window. You are able to decide upon to resize the page in relation to the drawing control's dimensions, or give a see just like Visio, displaying a part of the drawing page. Since the manage only supports just one window, you can not access the ShapeSheet or windows which include icon editor and master and group editing. The page and shape right-click menus are enabled by default. The constrained Visio UI for controlling shape conduct displays the intent of your control for being tightly integrated with all the container application. The top tactic for permitting customers to modify designs on a document may be to use a customized UI. However, if you'd like to utilize Visio menus and toolbars, the drawing handle does help menu and toolbar merging with all the host software. More than likely, your Visio drawing management software are going to be event-driven and react to customers clicking buttons or menu items contained with the software. The drawing handle also exposes Visio occasions, in order that you possibly can respond to a person clicking in the manage itself.Managing the Drawing Surface Screen You are able to modify the appearance in the Visio drawing control's surface through the control's Window residence. For instance, the following C# code hides the drawing control's scroll bars:This instance hides both the horizontal and vertical scroll bars. Other plausible values for that VisScrollbarStates enumeration include visScrollBarBoth (screen equally scroll bars), visScrollBarHoriz (display horizontal scroll bar), and visScrollBarVert (display vertical scroll bar).By removing areas from the Visio UI, you may make the drawing control start looking much more integrated within just your software. The following C# code hides the rulers:You can even change with the coloration on the window qualifications to match the colour scheme of your respective application. As an example, the subsequent C# code sets the window background coloration to sound red:In this particular example, the ColorTranslator class is made use of to convert a .NET shade sort into OLE_COLOR type, and that is the how Visio Automation specifies shades. Consumer Settings for that Visio Management The Visio drawing handle shares a similar underlying Application object as the Visio consumer software. That is why, in the event the consumer changes the software settings for that Visio client application (similar to turning the page track record blue), the identical settings utilize for the Visio control when running with the hosting software. The Visio control's HostID home allows you to store distinct person settings for your manage while in the registry. To set the HostID house, use a string to indicate the name in the subkey that should be formulated in the [HKEY_CURRENT_USERSoftwareMicrosoftOffice11.0VisioH osts] essential. Despite the fact that it is possible to use any string for that identify of the control's subkey, it's greatest to use a GUID to make certain uniqueness.The HostID property could be set at style time during the handle Properties window, or programmatically within the host software code.Page Sizing and Zoom Make use of the Visio drawing control's PageSizingBehavior house to resize the page with respect to the manage window. The default setting of this house (visNeverResizePages) gives a view much like that of Visio exactly where a portion of the page is viewable inside the window. The following C# code example resizes the page to match the management:When PageSizingBehavior is set to visResizePages,Windows 7 sale, the page's styles commonly are not resized with respect to the page. Designs stay positioned relative towards the coordinate model in the Visio page, which has its origin inside the lower left corner of the page. Sizing the page to match within the handle hides the page boundaries and is helpful in conditions the place the handle is sized for the optimum extent from the drawing surface.To rescale the whole page, together with its styles, in the drawing command window, set the Zoom house with the control's Window residence, as demonstrated within the subsequent C# instance:This code magnifies the window's contents by 200%. To consider impact, the zoom settings needs to be manufactured right after loading the document utilizing the Src property.To prevent the person from changing the zoom setting, set the ZoomLock house as shown inside the following C# example:You’re able to set the extent to which Visio controls the zoom through the VisZoomBehavior home, which can be accessed with the drawing control's Window or Document property. By default, the management uses the present zoom setting for that document. If you'd like to be capable of set the zoom to any stage, not just discrete settings which includes 50% or 100%, without the need of earning any adjustments for the appearance, set the VisZoomBehavior house towards the VisZoomVisioExact value, as proven during the following C# instance:Be aware You cannot resize the Visio drawing manage inside of a Phrase document. If you should resize the drawing management and help save the adjustments, the handle will reset to its default dimensions another time the Phrase document is opened. Form Search Window Management You’re able to "turn off" the Visio Form Search window during the document's stencil pane employing the Visio ItemFromID residence. For making the Shape Search window invisible from the stencil pane, set the property's Visible house to bogus,Microsoft Office 2007 Key, including:To expose the Form Search window inside stencil pane, set precisely the same worth to Valid.Be aware It is possible to only manage the visibility from the Form Search window on a per window basis. Integrating Menus and Toolbars The perfect practice when building an application making use of the Visio drawing management would be to apply a custom UI. If you'd like to exhibit Visio menus and toolbars in your container software, set the drawing control's NegotatiateToolbars and NegotiateMenus properties. The subsequent C# code permits both menu and toolbar merging:The top practice would be to set each of those properties to the exact value. The management will not help independent negotiation of toolbars and menus. The container software needs to help OLE menu merging in order to screen Visio menus or toolbars. For example, you are able to allow toolbar merging inside of a Word document. In the Visual Elementary undertaking in the Phrase document you could programmatically show Visio toolbars. The following instance displays the Layout & Routing toolbar.Very important Really do not attempt menu and toolbar merging with different active instances in the ActiveX control. Multiple cases in the control share just one underlying Visio Application object. You may very well get unexpected results when trying to undertake menu merging with just one Application object and a number of active instances of your management. Crucial Tend not to merge menus and toolbars along with the Word wide web Explorer person interface. There are known issues with menu merging in Word wide web Explorer (see the Microsoft Knowledge Base review 193098, PRB: Unexpected Menu Merging Conduct in World-wide-web Explorer). Menu and Toolbar Integration for Non-OLE Menu Merging Hosts In case your container does not support OLE menu merging (as an example, a Windows Kind), you can use the IOleCommandTarget interface to run Visio commands. You're able to put into action your own private menu item or toolbar button as demonstrated from the subsequent C# illustration:Immediately after you've gotten developed your menu item, use your IOleCommandTarget interface to apply the appropriate Visio user interface command for that target. The subsequent illustration permits the Connector tool when a menu item is clicked:Dealing with Events For less complicated use of Visio activities, the Visio drawing handle object exposes all Visio Window and Document occasions. This allows developers to access the events straight in the command rather that going with the Visio Document object.Mouse and keyboard occasions are commonly put into use with Visio management programming. You're able to use mouse occasions around the Visio drawing command to show customized Windows Sorts and update info in your own host programs. If you ever wish to "lock down" the Visio control's drawing surface and reduce end users from modifying any content specifically while in the drawing, you can actually listen for all keyboard and mouse occasions and "throw them away." In the event the hosting software "swallows" the mouse and keyboard activities, the Visio drawing surface would not react on the user's typing and mouse-click actions.Mouse and Keyboard Event Objects Celebration objects produced from the Visio AddAdvise technique offer the most impressive performance. You may make use of the Visio mouse and keyboard events like any other Visio celebration with AddAdvise. The following code sample demonstrates easy methods to capture a mouse occasion using an function sink in Visual Common six.0:The following code sample demonstrates tips on how to generate an occasion object for that mouse function by using the AddAdvise way. Delegates for Mouse-Click Events While by using celebration objects constructed with AddAdvise offers the perfect performance, you may also define a C# delegate inside of a Windows Sort to deal with mouse-click activities inside the drawing command window, as proven here:The function handler would then have the subsequent signature:Mouse Events for Shapes Visio mouse occasions are exposed on Page and Window objects. To locate a particular shape inside a page or window on which a consumer clicks, developers must utilize the Visio SpatialSearch way. The subsequent C# code passes while in the x- and y- coordinates for your click celebration about the window, sets Visio constants that dictate how you can set up the selection object, and defines a small tolerance in which to search around the x- and y- coordinates. If your tolerance is set to a very small unit relative to the dimension for the form, the selection object returned from the SpatialSearch methodology will only contain one shape, the one that the end consumer clicked on with the window.Deployment The Visio drawing handle is distributed through the Visio merchandise Setup course of action. Thus there are no supplemental licensing issues regarding the management itself. An application that hosts the drawing handle will not do the trick unless of course Visio is installed to the computer.The Visio drawing command is installed as aspect from the Minimal Set up option. In case your application is created in managed code and tends to make utilization of the Visio principal interop assemblies, it's essential to decide the Typical Set up option as a way to set up the Visio Key interop assemblies. To start with, make sure that the pc has the .NET Framework 1.1 installed; otherwise, the Visio Primary interop assemblies will not be installed. .NET Framework one.one will be the version that's installed with Visual Studio .NET 2003. For clients operating your software, you may also set up the free .NET Framework 1.one Redistributable as portion of the application's setup system.There are a couple options to deploy the Visio handle drawing instantly through the Visio item setup: Compose a Windows Installer setup plan and use "silent install" mode for corporate deployment. Contact the Visio solution Windows Installer bundle (the Visio .msi file) specifically. The following instance reveals the way you can make use of the Windows Script Host to silently set up Visio utilising the Typical Set up option:Conclusion The Visio drawing manage helps developers to extend customized applications and answers with the rich drawing performance of Visio. By providing programmability for your command and access towards the complete Visio object design, the Visio element will be driven by possibly consumer drawing actions or activities and info while in the host application. The advantages of options using the Visio drawing command are: Custom application consumers will not require knowledge of your Visio user interface to design drawings. Your software UI can drive drawing creation and abstract away Visio-specific tasks from the consumer. Visio remedy developers have a wider range of application hosts and choice of enhancement instruments. The Visio drawing control can be hosted inside of any ActiveX container. By using the Visio Major interop assemblies, you can also establish options working with the Visio drawing manage in managed code. Providing direct accessibility towards the Visio programming model would make remedies applying the Visio drawing manage simpler to produce and debug than answers that involve COM add-ins or VSLs. About the author Mark Bukovec is mostly a freelance developer and technical writer. Previously, Mark worked at Microsoft for five years, most recently being a program supervisor with all the COM+ group. You can actually contact Mark at empiredown@hotmail.com.