In This Topic
LightBox for ASP.NET Web Forms allows you to display images and content in a popup interface without ever leaving the page to view media. C1LightBox includes several unique features, including the following:
- Auto Play
Automatically display the pages in order with one property setting. You may also determine the time span between each page. When the last page is reached, by default the C1LightBox control starts displaying from the first page again. You can choose to disable the loop. See Automatically Playing the LightBox Items for details.
- Auto Size
C1LightBox can adjust its size automatically according to the image's width and height. This ensures the image displays in correct width/height ratio. This is enabled by setting the AutoSize property to True. See Automatically Sizing the LightBox's Content for details.
- Flash Content Support
Display SWF content in C1LightBox; the control creates a Flash Object automatically if the URL is a SWF file. For URLs that don't explicitly show the file links, set the Player property to SWF to force using the Flash Object as content player.
- Full Size Mode
C1LightBox can be enlarged to cover the entire window by clicking the FullSize button. To display the dialog box control buttons, set the DialogButtons property to one of the following values:
-
- None - No dialog buttons are displayed.
- Close - Displays the Close button.
- FullSize - Displays the FullSize button.
See Enabling Buttons in LightBox for more information.
- Keyboard Navigation
Navigate pages of content by keyboard. Setting the KeyNav property to True enables this feature. By default, the following keys are supported:
-
- LEFT/DOWN - Moves to the previous page.
- RIGHT/UP - Moves to the next page.
- HOME - Moves to the first page.
- END - Moves to the last page.
See Keyboard Interaction and Adding Keyboard Navigation to the LightBox for more information.
- Control Buttons: Play & Pause
To display the control buttons in C1LightBox, simply set the CtrlButtons property. Possible values include:
-
- None - No control buttons are displayed.
- Play - Displays the Play button.
- Stop - Displays the Stop button.
C1LightBox displays pages in order after clicking the Play button. If you want the C1LightBox control to play automatically after initializing, set the AutoPlay property to true. See Enabling Buttons in LightBox for more information.
- Counter Styles
- C1LightBox supports two types of counter style, determined by the CounterType property. When the CounterType property is Default, the CounterFormat property will be used to determine the format of counter text, with default value "[i] of [n]". "[i]" and "[n]" are built-in parameters that denote the current page index and total number of pages. When the CounterType property is Sequence, the CounterLimit property will be used to determine the maximum number of sequence index to display. See Setting the Sequence Counter in the LightBox for an example.
- Media Hosting
C1LightBox supports hosting media from external sources like Vimeo or YouTube, or media that could be played by Windows Media Player. If the URL is a file with .asf, .avi, .mpg, .mpeg, .wm, or .wmv extensions, the Windows Media Player Object will be created to play them by default. You can force the C1LightBox control to use the player of your choice by setting the Player property to one of the following:
-
- WMP - for Windows Media Player.
- Iframe - for Vimeo.
- SWF - for YouTube since the external link is a flash movie.
See Also