IHTMLElementDefaults::viewMasterTab Property

  • Article

Sets or retrieves a value that indicates whether the master element of a viewlink is included in the tab sequence of the primary document.

Syntax

HRESULT IHTMLElementDefaults::get_viewMasterTab(VARIANT_BOOL *p);
HRESULT IHTMLElementDefaults::put_viewMasterTab(VARIANT_BOOL v);

Parameters

  • p
    Pointer to a variable of type VARIANT_BOOL that receives one of the values listed in Possible Values.
  • v
    VARIANT_BOOL that specifies one of the values listed in Possible Values.

Possible Values

VARIANT_TRUE Default. Tabbing from an element in the primary document to a viewlink sets focus to the master element.
VARIANT_FALSE Tabbing from an element in the primary document to a viewlink sets focus to the next tab stop, bypassing the master element.

Return Value

Returns S_OK if successful, or an error value otherwise.

Remarks

Tabbing order goes from every tab stop within the viewlink to every tab stop in the primary document, based on sequence and IHTMLElement2::tabIndex value. By default, the master element participates in the tab sequence of the primary document, even if there are no tab stops defined within the viewlink.

When using a viewlink, the body element inside the viewlink is not tabbable by default; the author must set the tabIndex property if the behavior is designed to display a focus rectangle on the linked document. Setting the tabIndex property on the body of the document fragment causes the onfocus and onactivate events to fire when the viewlink document body receives focus.

See Also

IHTMLElementDefaults::viewLink, Introduction to Viewlink, About Element Behaviors