HLNF

HLNF

Values from the HLNF enumeration are used to indicate how the hyperlink navigation is to proceed, and also convey contextual information about the navigation from each of the objects participating in the navigation protocol to the others. These constants are used in the IHlink, IHlinkBrowseContext, IHlinkFrame, and IHlinkTarget interfaces and in the HlinkNavigateToStringReference, HlinkOnNavigate, HlinkSimpleNavigateToMoniker, and HlinkSimpleNavigateToString API functions.

typedef enum tagHLNF 

{ 

    HLNF_INTERNALJUMP             =  1, 

    HLNF_NAVIGATINGBACK           =  2, 

    HLNF_NAVIGATINGFORWARD        =  4, 

    HLNF_USEBROWSECONTEXTCLONE    =  8, 

    HLNF_OFFSETWINDOWORG          = 16, 

    HLNF_OPENINNEWWINDOW          = 24, 

    // (HLNF_USEBROWSECONTEXTCLONE | HLNF_OFFSETWINDOWORG),

    HLNF_CREATENOHISTORY          = 32, 

    HLNF_NAVIGATINGTOSTACKITEM    = 64  

} HLNF;

Members

HLNF_INTERNALJUMP

The navigation is an internal jump within the current hyperlink target. The system provided hyperlink object adds this flag to the grfHLNF passed to its IHlink::Navigate prior to calling IHlinkTarget::Navigate when it determines that its relative moniker is NULL. Sending this flag on to the hyperlink target allows the target to exclude any expensive operations and avoid spurious repainting during IHlinkTarget::Navigate.

HLNF_NAVIGATINGBACK

The navigation is occurring due to the Go Back command, in which case no history should be created in the browse context, and the current position in the navigation stack should be moved back one element. Hyperlink frames and hyperlink containers send this flag to IHlink::Navigate for their Go Back command.

HLNF_NAVIGATINGFORWARD

The navigation is occurring due to the Go Forward command, in which case no history should be created in the browse context, and the current position in the navigation stack should be moved forward one element. Hyperlink frames and hyperlink containers send this flag to IHlink::Navigate for their Go Forward command.

HLNF_USEBROWSECONTEXTCLONE

When called in IHlink::Navigate, the passed in IHlinkBrowseContext should be immediately cloned (via IHlinkBrowseContext::Clone) and used for all subsequent browse context calls and parameters to other methods.

HLNF_OFFSETWINDOWORG

Indicates that the hyperlink target should offset its frame- and/or document-level window(s) from the position returned in the HLBWINFO structure by IHlinkBrowseContext::GetBrowseWindowInfo during IHlinkTarget::Navigate. This flag is often passed in conjunction with HLNF_USEBROWSECONTEXTCLONE to implement an Open in New Window command.

HLNF_OPENINNEWWINDOW

An abbreviation for two commonly coincident options: HLNF_USEBROWSECONTEXTCLONE and HLNF_OFFSETWINDOWORG.

HLNF_CREATENOHISTORY

Indicates that the browse context should not during IHlinkBrowseContext::OnNavigateHlink add this hyperlink to the navigation stack.

HLNF_NAVIGATINGTOSTACKITEM

Indicates that the browse context should not during IHlinkBrowseContext::OnNavigateHlink add this hyperlink to the navigation stack, and further that it should update its current position to reflect that this hyperlink is the current hyperlink. This flag is used when, for example, the user selects a particular hyperlink from the navigation stack the user should navigate to the location, but the jump should not be recorded in the navigation stack, and the availability of the Go Forward and Go Back commands should be reevaluated.