As the slideshow is initializing, this method is called automatically in the host page. If the method is defined and returns a valid string value, the layout view corresponding to this return value will be opened as the initial view. For example, you might have defined the following view in your Layout XML in the XML configuration file: <view id="demoView" ... > . To dynamically make this view display first, the following method should be added to a javascript code block in your HTML page:

   <script language="javascript">
   function XMLFlashSlideshow_v4_getInitialViewID()
   {
    return "demoView";
   }
   </script>
       

Before the slideshow automatically opens the initial gallery, this method is called automatically in the host page. It allows you to override which gallery and image is displayed initially. If the method is defined and returns a valid image UniqueID value, the image corresponding to the returned UniqueID will be opened. For example, the following javascript code block in your HTML page would make the third image in the first gallery open initially:

   <script language="javascript">
   function XMLFlashSlideshow_v4_getInitialImage()
   {
    return "img_0_2";
   }
   </script>
  

This method is automatically called in the host page once the slideshow has initialized to the point of being ready to accept incoming calls. See the table below for more information on incoming calls, which allow your scripts to control the slideshow. For example, the following javascript code block could be placed in your HTML page:

   <script language="javascript">
   function XMLFlashSlideshow_v4_notifyReadyForImageSet()
   {
    // This method doesn't return anything...
    alert('The slideshow says it is ready for incoming calls!');
   }
   </script>
  

This method is automatically called in the host page whenever a gallery is opened. It allows your page to track the current gallery that is open in the slideshow. You could use this to display pertinent gallery-related information in the HTML page. For example, the following javascript code block could be placed in your HTML page to display an alert every time a new gallery is opened:

   <script language="javascript">
   function XMLFlashSlideshow_v4_syncGallery(uniqid)
   {
    // This method doesn't return anything...
    alert('The slideshow has just opened a gallery.  Here is its UniqueID: ' + uniqid);
   }
   </script>
  

This method is automatically called in the host page whenever an image starts to be opened/synced. It allows your page to track the current image that is open in the slideshow. You could use this to display pertinent image-related information in the HTML page, or to track which image is open and store the state in a cookie, etc. Or, you could use a package such as SWFAddress to enable back/forward button browser navigation. For example, the following javascript code block could be placed in your HTML page to display an alert every time a new image starts to open:

   <script language="javascript">
   function XMLFlashSlideshow_v4_syncImagesStart(uniqid)
   {
    // This method doesn't return anything...
    alert('The slideshow has just started to open a new image.  Here is its UniqueID: ' + uniqid);
   }
   </script>
  

This method is automatically called in the host page whenever an image has been opened/synced. It is called shortly after the above syncImagesStart method. It allows your page to track the current image that is open in the slideshow. You could use this to display pertinent image-related information in the HTML page, or to track which image is open and store the state in a cookie, etc. Or, you could use a package such as SWFAddress to enable back/forward button browser navigation. For example, the following javascript code block could be placed in your HTML page to display an alert every time a new image has opened:

   <script language="javascript">
   function XMLFlashSlideshow_v4_syncImages(uniqid)
   {
    // This method doesn't return anything...
    alert('The slideshow has just opened a new image.  Here is its UniqueID: ' + uniqid);
   }
   </script>
  

This call cannot be made until the XMLFlashSlideshow_v4_notifyReadyForImageSet() outgoing call has been made (see above). Calling this method opens the specific gallery identified by the passed gallery UniqueID. For example, the following snippet (which would need to be placed within some other block of code) would open the second gallery:

   <script language="javascript">
   ...
   // Open the second gallery
   XMLFlashSlideshow_v4_requestGallery("gallery_1");
   ...
   </script>
       

This call cannot be made until the XMLFlashSlideshow_v4_notifyReadyForImageSet() outgoing call has been made (see above). Calling this method opens the specific image identified by the passed image UniqueID. For example, the following snippet (which would need to be placed within some other block of code) would open the third image in the second gallery:

   <script language="javascript">
   ...
   // Open the third image in the second gallery
   XMLFlashSlideshow_v4_setImage("img_1_2");
   ...
   </script>