WebQuery Visual Design Window

Where:

  1. The URL you want to hit. This field is read from ISourceURL property and replaced with your example when it contains property substitution.

  2. If you change this text and hit GO (or enter), the visual browser will browse to the new URL. However, when saving and exiting, any property substitution that was used will be lost. This does not happen if you do not make any changes to the URL field. However, if the page redirects to a different URL, the same applies.

  3. A dropdown list box keeps all the previous hits during this session and the favourite menu stores a URL for future use.

  1. This is the portion of the URL that was replaced by an example. Saving without making any change to the URL will remove your example and get back the original property used.

  2. The area of the visual browser is enhanced to show you the relation between certain text and its innermost-enclosing node. Using the mouse to select the full line from Pronexus to the end of the phone number, the corresponding node with the tagName TR is being selected below in the document nodes hierarchy. Hover the mouse over any text in this area to show the text of the innermost node.

  3. This is the node selected when you click or select certain text in the visual browser above. Hover the mouse over one of these nodes to show the InnerText property of that node in the status bar below; the same text shown above when hovering over the corresponding text in 3. This helps you find the node you are searching for on the fly. Click the node you want to show its properties in the attributes on the right side of the window.

  4. This is the node we expect WebQuery to find in runtime. Right-click this element to reveal the following pop-up menu:

Context-sensitive menu of a node

  1. Suppose this is the node we want its InnerText and InnerHTML properties to be returned. Right-click this node (after you have set the node to search for in 5 above) and click Set as node to return in results from its context menu:

Context-sensitive menu of node after setting the node to search for

This should turn the previous node (5) to blue as the expected node to find, and this node to red as the returned one. Also, this should set the INodeOffset property to the correct number, which is the difference between those two nodes' sourceIndexes.

7. The status bar shows always the InnerText property of the node that the user is holding the mouse on, either in the visual browser panel or in the node hierarchy panel.

  1. Search Text box is where you edit the texts you want to search for and, as discussed, wildcards are acceptable.

  2. This text box shows you the value the INodeOffset property set in steps 5 and 6.

  3. The Next button finds the next match in the document that meets all your criteria. When the end of the document is reached, it prompts you to choose to restart from the beginning.

  4. Buttons to manage the property filters as follows:

  1. This panel shows the properties of the current node, the one selected in the node hierarchy panel on the left side of this window. Normal properties (or what are referred to as attributes in MSHTML documentation) are in black, but those that are specially added by WebQuery are in blue:

  1. The window title always shows the title of the page you are browsing.

  2. Always remember that INodeQueries property is set as the difference between the value of sourceIndex property of node you set as node to search for and the value of sourceIndex property of the node you set as node to return in results.

  3. These buttons save and exit this window.

  4. This button, as well as the following three, help you explore the document in the node hierarchy panel. Click this button to collapse all the hierarchy.

  5. Click this button to collapse only one level in depth of the hierarchy.

  6. Click this button to expand only one level in depth of the hierarchy.

  7. Click this button to expand all the nodes in the hierarchy.

  1. The properties that appear in blue in the node property panel are the specially added ones.

  2. The properties that appear in red are not actually properties that describe the node, rather they are properties that are set to be used as a filter but the currently selected node does not meet this criteria. This helps to determine why a certain node is not being selected (or found when clicking next). You can un-check the box beside one of these properties to loosen the criteria by removing this property from the filter list.

Read more about WebQuery control.