method Items.RemoveBar (Item as HITEM, [Key as Variant])
Removes a bar from an item.

 TypeDescription 
   Item as HITEM A long expression that indicates the the handle of the item where the bar is removed. If the Item parameter is 0, the RemoveBar method removes all bars with specified key from all items. In this case the DefaultItem property should be 0 ( by default ), else it refers a single item being indicated by the DefaultItem property.  
   Key as Variant A String expression that indicates the key of the bar to be removed. If missing, the Key parameter is empty. The Key may include a pattern with wild characters as *,?,# or [], if the Key starts with "<" and ends on ">" aka "<K*>" which indicates all bars with the key K or starts on K. The pattern may include a space which divides multiple patterns for matching. For instance "<A* *K>" indicates all keys that start on A and all keys that end on K.  
Use the RemoveBar method to remove a bar from an item. If the Item parameter is not 0 ( indicates a valid handle ), the RemoveBar removes a single bar ( if found, with the Key being specified by the Key parameter ). If the Item parameter is 0, the RemoveBar method removes all bars with specified key from all items. Use the BeginUpdate / EndUpdate methods to refresh the control's content after removing a bar or several bars. Use the ClearBars method to remove all bars in the item. 

Based on the values of Item and Key parameters the RemoveBar property remove none, one or multiple bars as follow: 

The pattern may include the space character which indicates multiple patterns to be used when matching. For instance "A* *K" indicates all keys that start on A and all keys that end on K. 

Here's few samples of using the RemoveBar method:

Use the AddBar method to add new bars to the item. Use the Remove method to remove a type of bar from the Bars collection. Use the Add method to add new types of bars to the Bars collection. Use the FirstVisibleDate property to specify the first visible date in the chart area. Use the Key parameter to identify a bar inside an item. Use the ItemBar property to access a bar inside the item. Use the PaneWidth property to specify the width of the chart. Use the NonworkingDays property to specify the non-working days.

 


Send comments on this topic.
1999-2017 Exontrol.COM, Software. All rights reserved.