IHTMLScreen

IHTMLScreen


This interface supplies information about the client's screen and rendering capabilities.

IHTMLScreen Methods
get_colorDepth   put_bufferDepth   get_bufferDepth  
get_width   get_height   put_updateInterval  
get_updateInterval   get_availHeight   get_availWidth  
get_fontSmoothingEnabled

IHTMLScreen::get_colorDepth

HRESULT get_colorDepth(
    long *p 
) ;

Retrieves the bits-per-pixel used for colors on the destination device or buffer. Script programmers use this value when deciding how best to use colors.

p
Address of a variable that receives the color depth.

The value of this read-only property depends on the bufferDepth property. If bufferDepth is 0 or -1, colorDepth is equal to the bits-per-pixel value for the screen or printer. If bufferDepth is non-zero, colorDepth is equal to bufferDepth.

IHTMLScreen::put_bufferDepth

HRESULT put_bufferDepth(
    long v 
);

Sets an offscreen bitmap buffer.

v
Value specifying the buffer depth. Can be one of these values:
0 No explicit buffering. The colorDepth property is set to the screen depth.
-1 Perform buffering at the screen depth. The colorDepth property is set to the screen depth.
1, 4, 8, 15, 16, 24, or 32 Perform buffering using the given bits-per-pixel. The colorDepth is also set to this value. The value 15 specifies 16 bits-per-pixel, in which only 15 bits are used in a 5-5-5 layout of RGB values.

Nonsupported values cause bufferDepth to be set to -1. When bufferDepth is -1 and the user changes system settings that affect the screen depth, the buffer depth is automatically updated to the new depth. This is not the case if you set bufferDepth to a specific value.

See also get_bufferDepth

IHTMLScreen::get_bufferDepth

HRESULT get_bufferDepth(
    long *p 
);

Retrieves an offscreen bitmap buffer.

p
Address of a variable that receives the buffer depth. Can be one of these values:
0 No explicit buffering. The colorDepth property is set to the screen depth.
-1 Perform buffering at the screen depth. The colorDepth property is set to the screen depth.
1, 4, 8, 15, 16, 24, or 32 Perform buffering using the given bits-per-pixel. The colorDepth is also set to this value. The value 15 specifies 16 bits-per-pixel, in which only 15 bits are used in a 5-5-5 layout of RGB values.

Nonsupported values cause bufferDepth to be set to -1. When bufferDepth is -1 and the user changes system settings that affect the screen depth, the buffer depth is automatically updated to the new depth. This is not the case if you set bufferDepth to a specific value.

See also put_bufferDepth

IHTMLScreen::get_width

HRESULT get_width(
    long *p 
);

Retrieves the horizontal resolution of the screen, in pixels.

p
Address of a variable that receives the horizontal resolution.

See also get_height

IHTMLScreen::get_height

HRESULT get_height(
    long *p 
);

Retrieves the vertical resolution of the screen, in pixels.

p
Address of a variable that receives the vertical resolution.

See also get_width

IHTMLScreen::put_updateInterval

HRESULT put_updateInterval(
    long v 
);

Sets the update interval for the screen. The interval causes invalidation's to the window to be buffered and then drawn in the given millisecond intervals. The purpose is to limit excessive invalidation's that reduce the overall painting performance, which can happen if there is an overabundance of flipbook-style animation's occurring at once.

v
Value specifying the number of milliseconds between updates to the screen. A value of zero disables the update interval.

Use this property judiciously—a value too small or too large will adversely affect the page rendering response.

See also get_updateInterval

IHTMLScreen::get_updateInterval

HRESULT get_updateInterval(
    long *p 
);

Retrieves the update interval for the screen. The interval causes invalidations to the window to be buffered and then drawn in the given millisecond intervals. The purpose is to limit excessive invalidations that reduce the overall painting performance, which can happen if there is an overabundance of flipbook-style animations occurring at once.

p
Address of a variable that receives the number of milliseconds between updates to the screen. This parameter receives zero (0) if the update interval is disabled.

See also put_updateInterval

IHTMLScreen::get_availHeight

HRESULT get_availHeight(
    long *p 
);

Retrieves the height of the working area of the system's screen.

p
Address of a variable that receives the height value.

See also get_availWidth

IHTMLScreen::get_availWidth

HRESULT get_availWidth(
    long *p 
);

Retrieves the width of the working area of the system's screen.

p
Address of a variable that receives the width value.

See also get_availHeight

IHTMLScreen::get_fontSmoothingEnabled

HRESULT get_fontSmoothingEnabled(
    VARIANT_BOOL *p 
);

Retrieves a Boolean of the system setting indicating whether font smoothing is enabled.

p
Address of a variable that receives TRUE if font smothing is enabled, or FALSE otherwise.

© 1997 Microsoft Corporation. All rights reserved. Terms of Use.