
This interface is used to specify a MARQUEE element. The MARQUEE tag enables you to create a scrolling text marquee, and control its content.
IHTMLMarqueeElement Methods
HRESULT put_bgColor(
VARIANT v
);
Sets the background color behind the element.
See also get_bgColor
HRESULT get_bgColor(
VARIANT *p
);
Retrieves the background color behind the element.
See also put_bgColor
HRESULT put_scrollDelay(
long v
);
Sets the speed at which the MARQUEE scrolls.
See also get_scrollDelay
HRESULT get_scrollDelay(
long *p
);
Retrieves the speed at which the MARQUEE scrolls.
See also put_scrollDelay
HRESULT put_direction(
BSTR v
);
Sets the direction in which the text scrolls.
| down | The marquee scrolls down. |
| left | The marquee scrolls left. This is the default value. |
| right | The marquee scrolls right. |
| up | The marquee scrolls up. |
See also get_direction
HRESULT get_direction(
BSTR *p
);
Retrieves the current direction in which the text scrolls.
| down | The marquee scrolls down. |
| left | The marquee scrolls left. This is the default value. |
| right | The marquee scrolls right. |
| up | The marquee scrolls up. |
See also put_direction
HRESULT put_behavior(
BSTR v
);
Sets how the text scrolls in the MARQUEE.
| alternate | The marquee alternates left and right. |
| scroll | The marquee is a scrolling marquee in the direction specified by the direction attribute. The text scrolls off the end and starts over. |
| slide | The marquee is a scrolling marquee in the direction specified by the direction attribute. The text scrolls to the end and stops. |
See also get_behavior
HRESULT get_behavior(
BSTR *p
);
Retrieves how the text scrolls in the marquee.
| alternate | The marquee alternates left and right. |
| scroll | The marquee is a scrolling marquee in the direction specified by the direction attribute. The text scrolls off the end and starts over. |
| slide | The marquee is a scrolling marquee in the direction specified by the direction attribute. The text scrolls to the end and stops. |
See also put_behavior
HRESULT put_scrollAmount(
long v
);
Sets the number of pixels the text scrolls between each subsequent drawing of the MARQUEE.
See also get_scrollAmount
HRESULT get_scrollAmount(
long *p
);
Retrieves the number of pixels the text scrolls between each subsequent drawing of the MARQUEE.
See also put_scrollAmount
HRESULT put_loop(
long v
);
Sets the number of times the MARQUEE should loop.
Below are descriptions on how loop works for some boundary cases.
| <BGSOUND src="file:///c:\win95\system\msremind.wav"> | once |
| <BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP> | once |
| <BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=> | zero times |
| <BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=-1> | infinitely |
| <BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=0> | once |
See also get_loop
HRESULT get_loop(
long *p
);
Retrieves the number of times the MARQUEE will loop.
Below are descriptions on how loop works for some boundary cases.
| <BGSOUND src="file:///c:\win95\system\msremind.wav"> | once |
| <BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP> | once |
| <BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=> | zero times |
| <BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=-1> | infinitely |
| <BGSOUND src="file:///c:\win95\system\msremind.wav" LOOP=0> | once |
See also put_loop
HRESULT put_vspace(
long v
);
Sets the vertical margins for the element.
Similar to border, except the margins are not painted with color when the element is a link.
See also get_vspace
HRESULT get_vspace(
long *p
);
Retrieves the vertical margins for the element.
Similar to border, except the margins are not painted with color when the element is a link.
See also put_vspace
HRESULT put_hspace(
long v
);
Sets the horizontal margins for the element.
Similar to border, except the margins are not painted with color when the element is a link.
See also get_hspace
HRESULT get_hspace(
long *p
);
Retrieves the horizontal margins for the element.
Similar to border, except the margins are not painted with color when the element is a link.
See also put_hspace
HRESULT put_onfinish(
VARIANT v
);
Sets the inline script associated with the onfinish event on the MARQUEE element. This event is fired when the looping is complete.
For more information on inline script, see Attaching an Event Handler in the Understanding the Event Model documentation.
See also get_onfinish
HRESULT get_onfinish(
VARIANT *p
);
Retrieves the inline script associated with the onfinish event on the MARQUEE element. This event is fired when the looping is complete.
For more information on inline script, see Attaching an Event Handler in the Understanding the Event Model documentation.
See also put_onfinish
HRESULT put_onstart(
VARIANT v
);
Sets the inline script associated with the onstart event on the MARQUEE element. This event is fired when a loop begins, and when a bounce cycle begins for alternate behavior.
For more information on inline script, see Attaching an Event Handler in the Understanding the Event Model documentation.
See also get_onstart
HRESULT get_onstart(
VARIANT *p
);
Retrieves the inline script associated with the onstart event on the MARQUEE element. This event is fired when a loop begins, and when a bounce cycle begins for alternate behavior.
For more information on inline script, see Attaching an Event Handler in the Understanding the Event Model documentation.
See also put_onstart
HRESULT put_onbounce(
VARIANT v
);
Sets the inline script associated with the onbounce event on the MARQUEE element. This event is fired when the behavior property of the MARQUEE element is set to "alternate", and the content of the marquee reaches the specified side.
For more information on inline script, see Attaching an Event Handler in the Understanding the Event Model documentation.
See also get_onbounce
HRESULT get_onbounce(
VARIANT *p
);
Retrieves the inline script associated with the onbounce event on the MARQUEE element. This event is fired when the behavior property of the MARQUEE element is set to "alternate", and the content of the marquee reaches the specified side.
For more information on inline script, see Attaching an Event Handler in the Understanding the Event Model documentation.
See also put_onbounce
HRESULT put_width(
VARIANT v
);
Sets the calculated width of the element, in pixels.
This property is an integer value. Although an HTML author can specify the width as a percentage, this property always specifies the width in pixels.
See also get_width
HRESULT get_width(
VARIANT *p
);
Retrieves the calculated width of the element, in pixels.
This read-only property is an integer value. Although an HTML author can specify the width as a percentage, this property always specifies the width in pixels.
See also put_width
HRESULT put_height(
VARIANT v
);
Sets the calculated height of the element, in pixels.
If the value of the corresponding HTML attribute was set using a percentage, this property specifies the height in pixels represented by that percentage.
See also get_height
HRESULT get_height(
VARIANT *p
);
Retrieves the calculated height of the element, in pixels.
If the value of the corresponding HTML attribute was set using a percentage, this property specifies the height in pixels represented by that percentage.
See also put_height
HRESULT put_trueSpeed(
VARIANT_BOOL v
);
Sets whether the position of the marquee is calculated using the scrollDelay and scrollAmount properties, and the actual time elapsed from the last clock tick.
| TRUE | The marquee advances the pixel value of scrollAmount per the number of milliseconds (ms) set for scrollDelay. For example, the marquee advances 10 pixels for every 6ms if scrollDelay is 6 and scrollAmount is 10. |
| FALSE | The marquee computes movement based on 60ms ticks of the clock. This means every scrollDelay value under 60 is essentially ignored, and the marquee advances the amount of scrollAmount each 60ms. For example, if scrollDelay is 6 and scrollAmount is 10, the marquee advances 10 pixels every 60ms. |
By default, this property is FALSE.
See also get_trueSpeed
HRESULT get_trueSpeed(
VARIANT_BOOL *p
);
Retrieves whether the position of the marquee is calculated using the scrollDelay and scrollAmount properties, and the actual time elapsed from the last clock tick.
| TRUE | The marquee advances the pixel value of scrollAmount per the number of milliseconds (ms) set for scrollDelay. For example, the marquee advances 10 pixels for every 6ms if scrollDelay is 6 and scrollAmount is 10. |
| FALSE | The marquee computes movement based on 60ms ticks of the clock. This means every scrollDelay value under 60 is essentially ignored, and the marquee advances the amount of scrollAmount each 60ms. For example, if scrollDelay is 6 and scrollAmount is 10, the marquee advances 10 pixels every 60ms. |
By default, this property is FALSE.
See also put_trueSpeed
HRESULT start(
void
);
Begins scrolling the marquee.
See also stop
HRESULT stop(
void
);
Stops scrolling the marquee.
See also start
© 1997 Microsoft Corporation. All rights reserved. Terms of Use.