Full Screen Graphics and Viewer Startup Screen

This article has been archived. It is offered "as is" and will no longer be updated.
This article explains how to display large graphics in Viewer without usingscroll bars. The first method described below also explains how to makethis graphic topic appear as the first topic you see when Viewer starts up.Three methods for displaying large graphics in Viewer are listed below:
  • Put your graphic in the non scrolling region of the master pane of either the main window or a custom-defined secondary window.

  • Put your graphic in a customized regular pane that is sized to fill the entire window (maximum width and height set to the device-independent value 1023). Regular panes never have scroll bars.

  • Put your graphic in a pop-up window. The default pop-up window will size itself to either the maximum extent of the graphic or the the maximum size of the main Viewer window (whichever is smaller). Pop-up windows in Viewer never have scroll bars.
More information

Displaying Graphics in the Master Pane of Any Window

In the Noncrolling Region:

If you want the large graphic to appear at the top of the topic or at thevery bottom of the topic, you can place your graphic in a non scrollingregion (see pages 3-30 and 5-33 of the "Authoring Guide"). Or, if thegraphic is the only item in the entire topic, define the whole topic as anon scrolling region.

NOTE: The default action of Viewer is to put a line between the scrollingand non scrolling regions. You can remove the line between the scrollingand non scrolling regions by editing the properties of the master pane inthe Window Definitions dialog box. Page 5-18 of the Authoring Guide, itdescribes the properties of the master pane. Set the border of the nonscrolling region to "none" in the Window Definitions dialog box.

In the Scrolling Region:

If you must place your large graphic in the scrolling region, you must makesome sacrifices. You need to decide the most common screen size(s) andresolution(s) your customers will use. You might assume that customers withsmaller resolutions would have 4-bit displays and customers with higherresolution monitors would have 8-bit or higher displays (see "DisplayingAlternate Pictures" on page 9-20 of the "Authoring Guide"). Using thatassumption, you might place a 620x470 bitmap in the 4-bit option of the ewXstatement, and use a 720x590 bitmap in the 8-bit option of the ewXstatement. The border of the master pane, the border of the window, thebutton bar, the menu bar, and the window caption take up a few pixels thatyou will need to account for when resizing your bitmaps.

NOTE: If you want to make more space for your bitmap, you can useHideButtonBar() and/or HideMenuBar(). Page 5-3 of the "Authoring Guide"shows a Viewer screen with no button bar or menu bar. You can also removethe window caption and maximize and minimize buttons using the Windows API(application programming interface) call to SetWindowLong(). You can alsotemporarily change the size of your window or master pane usingPositionWindow(), PositionMaster(), or PositionTopic(). For additionalinformation on changing the main window, please see the followingarticle(s) in the Microsoft Knowledge Base:
83915SAMPLE: Adding and Removing Caption of a Window
TIP: To make this graphic topic your "startup screen," just specify thistopic as the CONTENTS option (see page 3-11 of the "Authoring Guide"). Youcan provide an easy exit from your graphic screen by either creating ahotspot on the bitmap that runs a JumpID() command, or you can make thewhole bitmap into a hotspot using the ewX statement and the "When Clicked,Run Command" section (see page 9-17 of the "Authoring Guide"). If yourgraphic is a startup screen, then the default Contents button will jump tothe bitmap topic instead of your table of contents. You can change theContents button function with a ChangeButtonBinding() command (see page 5-29 of the "Technical Reference").

Displaying Graphics in a Regular Pane

Regular panes cannot have scroll bars. You can set the size of a regularpane in the Window Definitions section of your project file. (see pages 5-3to 5-10 and 5-21 to 5-23 of the "Authoring Guide").

TIP: You can provide an easy exit from a full page bitmap screen by eithercreating a hotspot on the bitmap that runs a ClosePane() command, or youcan make the whole bitmap into a hotspot using the ewX statement and the"When Clicked, Run Command" section (see page 9-17 of the "AuthoringGuide").

Displaying Graphics in a Pop-up Window

The default pop-up window will size itself to a rectangle that just fitsall text and bitmaps in the topic. If the text and bitmaps fill a rectanglethat is bigger than the Viewer window, then the image will be clipped. Youcan also set a custom pop-up window size and color (see page 5-24 of the"Authoring Guide").

TIP: You can close a pop-up window by clicking with the mouse anywhereoutside of the pop-up window. You can also use the ESC key on you keyboardto close a pop-up window. You can also place hotspots on the bitmap to runany kind of jump. There is no command that closes a pop-up window.
2.00 2.00a popup

Article ID: 110312 - Last Review: 01/09/2015 05:03:10 - Revision: 3.0

Microsoft Multimedia Viewer Publishing Toolkit 2.0

  • kbnosurvey kbarchive KB110312