IMarkupPointer Interface

IID_IMarkupPointer

{3050F49F-98B5-11CF-BB82-00AA00BDCE0B}

This interface, along with the IMarkupServices interface, allows the contents of the page to be programmatically manipulated from your C++ program.

Documentation: IMarkupPointer Interface

Methods in VTable order

IUnknown Methods

Description

QueryInterface

Returns pointers to supported interfaces.

AddRef

Increments reference count.

Release

Decrements reference count.

IMarkupPointer Methods

Description

OwningDoc

Retrieves the top-level document associated with this object.

Gravity

Retrieves the gravity attribute of this pointer.

SetGravity

Sets the gravity attribute of this pointer.

Cling

Retrieves the cling attribute for this markup pointer.

SetCling

Sets or resets the cling attribute of a markup pointer.

Unposition

Resets the position of the pointer.

IsPositioned

Checks the position of the pointer.

GetContainer

Retrieves the container associated with this markup pointer.

MoveAdjacentToElement

Moves the pointer adjacent to an element.

MoveToPointer

Moves this pointer to another pointer's location.

MoveToContainer

Moves the pointer to a markup container.

Left

Inspects the content of the container to the left of the markup pointer and optionally moves the pointer one position to the left.

Right

Inspects the content of the container to the right of the markup pointer and optionally moves the pointer one position to the right.

CurrentScope

Retrieves the IHTMLElement positioned in this pointer.

IsLeftOf

Checks to see whether this pointer's position is to the left of another pointer's position.

IsLeftOfOrEqualTo

Checks to see whether this pointer's position is to the left of or is equal to another pointer's position.

IsRightOf

Checks to see whether this pointer's position is to the right of another pointer's position.

IsRightOfOrEqualTo

Checks to see whether this pointer's position is to the right of or is equal to another pointer's position.

IsEqualTo

Checks to see whether this pointer's position is equal to another pointer's position.

MoveUnit

Moves the pointer one unit.

FindText

Searches for specified text, from the current pointer's position to another pointer's position.

OwningDoc

FUNCTION IMarkupPointer_OwningDoc ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppdoc AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[3] USING IMarkupPointer_OwningDoc (pthis, ppdoc) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Gravity

FUNCTION IMarkupPointer_Gravity ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pGravity AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[4] USING IMarkupPointer_Gravity (pthis, pGravity) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

SetGravity

FUNCTION IMarkupPointer_SetGravity ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pGravity AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[5] USING IMarkupPointer_SetGravity (pthis, pGravity) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Cling

FUNCTION IMarkupPointer_Cling ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pfCLing AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[6] USING IMarkupPointer_Cling (pthis, pfCLing) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

SetCling

FUNCTION IMarkupPointer_SetCling ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pfCLing AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[7] USING IMarkupPointer_SetCling (pthis, pfCLing) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Unposition

FUNCTION IMarkupPointer_Unposition ( _
  BYVAL pthis AS DWORD PTR _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[8] USING IMarkupPointer_Unposition (pthis) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsPositioned

FUNCTION IMarkupPointer_IsPositioned ( _
  BYVAL pthis AS DWORD PTR _
, BYREF pfPositioned AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[9] USING IMarkupPointer_IsPositioned (pthis, pfPositioned) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

GetContainer

FUNCTION IMarkupPointer_GetContainer ( _
  BYVAL pthis AS DWORD PTR _
, BYREF ppContainer AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[10] USING IMarkupPointer_GetContainer (pthis, ppContainer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

MoveAdjacentToElement

FUNCTION IMarkupPointer_MoveAdjacentToElement ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pElement AS DWORD _
, BYVAL eAdj AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[11] USING IMarkupPointer_MoveAdjacentToElement (pthis, pElement, eAdj) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

MoveToPointer

FUNCTION IMarkupPointer_MoveToPointer ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pPointer AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[12] USING IMarkupPointer_MoveToPointer (pthis, pPointer) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

MoveToContainer

FUNCTION IMarkupPointer_MoveToContainer ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pContainer AS DWORD _
, BYVAL fAtStart AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[13] USING IMarkupPointer_MoveToContainer (pthis, pContainer, fAtStart) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

Left

DECLARE FUNCTION Proto_IMarkupPointer_Left ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL fMove AS LONG _
, BYREF pContext AS LONG _
, BYREF ppElement AS DWORD _
, BYREF pcch AS LONG _
, BYREF pchText AS DWORD _
  ) AS LONG
 

FUNCTION IMarkupPointer_Left ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL fMove AS LONG _
, BYREF pContext AS LONG _
, BYREF ppElement AS DWORD _
, BYREF pcch AS LONG _
, BYREF strText AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG

  LOCAL pchText AS DWORD

  LOCAL bstrlen AS LONG

  CALL DWORD @@pthis[14] USING Proto_IMarkupPointer_Left (pthis, fMove, pContext, ppElement, pcch, pchText) TO HRESULT

  IF ISTRUE pchText THEN

     bstrlen = lstrlenW(BYVAL pchText)

     strText = PEEK$(pchText, bstrlen * 2)

  END IF

  CoTaskMemFree pchText
  FUNCTION = HRESULT

END FUNCTION
 

Right

DECLARE FUNCTION Proto_IMarkupPointer_Right ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL fMove AS LONG _
, BYREF pContext AS LONG _
, BYREF ppElement AS DWORD _
, BYREF pcch AS LONG _
, BYREF pchText AS DWORD _
  ) AS LONG
 

FUNCTION IMarkupPointer_Right ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL fMove AS LONG _
, BYREF pContext AS LONG _
, BYREF ppElement AS DWORD _
, BYREF pcch AS LONG _
, BYREF strText AS STRING _
  ) AS LONG

  LOCAL HRESULT AS LONG

  LOCAL pchText AS DWORD

  LOCAL bstrlen AS LONG

  CALL DWORD @@pthis[15] USING Proto_IMarkupPointer_Right (pthis, fMove, pContext, ppElement, pcch, pchText) TO HRESULT

  IF ISTRUE pchText THEN

     bstrlen = lstrlenW(BYVAL pchText)

     strText = PEEK$(pchText, bstrlen * 2)

  END IF

  CoTaskMemFree pchText
  FUNCTION = HRESULT

END FUNCTION
 

CurrentScope

FUNCTION IMarkupPointer_CurrentScope ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL ppElemCurrent AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[16] USING IMarkupPointer_CurrentScope (pthis, ppElemCurrent) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsLeftOf

FUNCTION IMarkupPointer_IsLeftOf ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pPointerThat AS DWORD _
, BYREF pfResult AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[17] USING IMarkupPointer_IsLeftOf (pthis, pPointerThat, pfResult) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsLeftOfOrEqualTo

FUNCTION IMarkupPointer_IsLeftOfOrEqualTo ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pPointerThat AS DWORD _
, BYREF pfResult AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[18] USING IMarkupPointer_IsLeftOfOrEqualTo (pthis, pPointerThat, pfResult) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsRightOf

FUNCTION IMarkupPointer_IsRightOf ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pPointerThat AS DWORD _
, BYREF pfResult AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[19] USING IMarkupPointer_IsRightOf (pthis, pPointerThat, pfResult) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsRightOfOrEqualTo

FUNCTION IMarkupPointer_IsRightOfOrEqualTo ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pPointerThat AS DWORD _
, BYREF pfResult AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[20] USING IMarkupPointer_IsRightOfOrEqualTo (pthis, pPointerThat, pfResult) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

IsEqualTo

FUNCTION IMarkupPointer_IsEqualTo ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL pPointerThat AS DWORD _
, BYREF pfResult AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[21] USING IMarkupPointer_IsEqualTo (pthis, pPointerThat, pfResult) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

MoveUnit

FUNCTION IMarkupPointer_MoveUnit ( _
  BYVAL pthis AS DWORD PTR _
, BYREF muAction AS LONG _
  ) AS LONG

  LOCAL HRESULT AS LONG
  CALL DWORD @@pthis[22] USING IMarkupPointer_MoveUnit (pthis, muAction) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION
 

FindText

FUNCTION IMarkupPointer_FindText ( _
  BYVAL pthis AS DWORD PTR _
, BYVAL strFindText AS STRING _
, BYVAL dwFlags AS DWORD _
, BYVAL pIEndMatch AS DWORD _
, BYVAL pIEndSearch AS DWORD _
  ) AS LONG

  LOCAL HRESULT AS LONG

  strFindText = UCODE$(strFindText) & $NUL
  CALL DWORD @@pthis[23] USING Proto_IMarkupPointer_FindText (pthis, strFindText, dwFlags, pIEndMatch, pIEndSearch) TO HRESULT
  FUNCTION = HRESULT

END FUNCTION