# SalTreeControl Namespace: **PPJ.Runtime.Windows** Assembly: **PPJ.Runtime.49** (4.9.0.0) TreeView implementation. {% tabs %} {% tab title="C#" %} ```csharp public class SalTreeControl : TreeView, ISalWindow, ISalControl ``` {% endtab %} {% tab title="VB.NET" %} ```visual-basic Public Class SalTreeControl Inherits TreeView Implements ISalWindow, ISalControl ``` {% endtab %} {% endtabs %} ## Constructors ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SalTreeControl() Constructs a SalTreeControl object. ## Properties ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)Label [Control](https://docs.microsoft.com/en-us/dotnet/api/system.windows.forms.control): Returns/Sets the label associated with this control. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)NamedProperties [SalNamedProperties](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol): Returns the collection of named properties. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ShowRoot [Boolean](https://docs.microsoft.com/en-us/dotnet/api/system.boolean): Shows the root node. ## Methods ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)BringWindowToTop() Brings a window to the top of all overlapping windows. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)CenterWindow() Centers a window. If the window is a top-level window, it centers it on the desktop. If the window is a child window, it centers it on top of its parent. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)Clear() Clears the value from a data field, multi line field, or table window column. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ClearCursor(type) Clears a window's cursor. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ----------- | | **type** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)CollapseItem(hItem) Collapse a tree item. If the tree item handle is 0, then the top level tree items of the tree control are collapsed. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)DeleteItem(hItem) Removes a tree item from a tree control. All child items of the tree item are also removed. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the item was deleted successfully. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)DemoteItem(hItem) Moves a tree item so it becomes the child of its previous sibling. This function will fail if the tree item has no previous sibling. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)DestroyWindow() Destroys a form window, a top-level table window, or a modeless dialog box created with SalCreateWindow. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)DisableWindow() Disables keyboard and mouse input to a window. If the window contains text (for example, a push button), the text is grayed. If the window is a data field, it cannot receive the focus. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)DisableWindowAndLabel() Disables keyboard and mouse input to a window and grays out its associated label. A label is the label control that immediately precedes the window in the outline. The label control must have a mnemonic. If the window contains text (for example, a push button), the text is grayed. If the window is a data field, it cannot receive the focus. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)EditItem(hItem) Allows the user to edit the value of the tree item's label. SAM\_Validate is sent to the tree control when the edit control loses focus with wParam indicating the handle to the tree item. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if edit has been activated. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)EnableItem(hItem, bEnable) Enables the tree item when *bEnable* is true, disables the tree item when *bEnable* is false. | Parameter | Type | Description | | ----------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **bEnable** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Set to TRUE to enable the item. Set to FALSE to disable the item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). previous state of the item before this function was called. TRUE if it was enabled, FALSE if it was disabled. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)EnableWindow() Enables keyboard and mouse input to a window. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)EnableWindowAndLabel() Enables keyboard and mouse input to a window and enables its associated label as well. A label is the label control that immediately precedes the window in the outline. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ExpandItem(hItem) Expand a tree item. If the tree item handle is 0, then the top level tree items of the tree control are expanded. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)FindChild(windowName) This function finds a child window of a given name in the specified window. | Parameter | Type | Description | | -------------- | --------------------------------------------------------------------------------------- | ----------- | | **windowName** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)FindItemByData(hItem, nData) Finds a tree item by its Object Data. Returns 0 if not found. Searches the child items of the tree item handle argument(hItem). If the handle is 0, searches the top level tree items. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **nData** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Data of the item to find. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Handle of the tree item whose Data matches the nData parameter. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)FindItemByTitle(hItem, sTitle) Finds a tree item by its object title. Returns 0 if not found. Searches the child items of the tree item handle argument. If the handle is 0, searches the top level tree items. | Parameter | Type | Description | | ---------- | --------------------------------------------------------------------------------------- | -------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **sTitle** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Title of the item to find. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Handle of the item whose title matches the sTitle parameter. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)FireWindowActions(msg, mywParam, mylParam) Dispatches the specified message (Window Actions) directly to the control's WindowActions event handlers, without going through Windows message loop. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ----------- | | **msg** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **mywParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **mylParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)FormUnitsToPixels(formUnits, vertical) Computes the number of pixels in the number of form units. Form units are a unit of measurement used by functions which move and position objects. Form units are computed using physical units (pixels) in conjunction with the window's font size. | Parameter | Type | Description | | ------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **formUnits** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | The number of form units. | | **vertical** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetClassName() Return the name of a window's class as a string. **Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetControlType() Returns an object's type. **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetDataType() Returns a data field's or table window column's data type. **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetFirstChild(typeMask) Returns the handle of the first child window of the specified type. You can use this function to get the handles of MDI child windows. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | **typeMask** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | One or more window types combined (using the OR (\|) operator) to create a mask of child window types. | **Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetFirstItem(hItem) Gets the first child tree item of the passed tree item handle. Returns 0 if not found. If the handle is 0, returns the first child of the tree control. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Handle of the tree item. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetFont(name, size, enhancement) | Parameter | Type | Description | | --------------- | ---------------------------------------------------------------------------------------- | ----------- | | **name** | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **size** | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **enhancement** | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetItemCount(hItem) Gets the number of child items. If the handle argument is 0, then number of first level child items is returned. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Number of items. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetItemData(hItem) Returns the numeric value assigned to the tree item. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Numeric value assigned to the tree item. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetItemParent(hItem) Returns the handle of hItem's parent, or 0 if hItem is a top level child of the tree control. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Handle of hItem's parent. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetItemText(hItem) Returns the string title of the item. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). String title of the item. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetItemTooltip(hItem) Returns the current tooltip for the tree item. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Current tooltip for the tree item. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetLabel() Retrieves the window handle of the label (label control) that is associated with the hWndTarget parameter. There must be a mnemonic in that label, and it must immediately precede hWndTarget in the outline, or this function will fail. **Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetLabelText(sText, nMaxLength) | Parameter | Type | Description | | -------------- | ---------------------------------------------------------------------------------------- | ----------- | | **sText** | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **nMaxLength** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetLabelText(nMaxLength) Retrieves the text of the label associated to a control. Important: The label control does not require a mnemonic for the functions listed above to operate. | Parameter | Type | Description | | -------------- | --------------------------------------------------------------------------------------- | ----------- | | **nMaxLength** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetLocation(x, y) | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------- | ----------- | | **x** | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **y** | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetName(text) | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------- | ----------- | | **text** | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetName() Gets the name of an object. **Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetNextChild(typeMask) Returns the handle of the next child window that matches a specified type. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------ | | **typeMask** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | One or more window types combined (using the OR (\|) operator) to create a mask of child window types. | **Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetNextItem(hItem) Gets the next sibling tree item of the passed tree item handle. Returns 0 if there are no more sibling tree items. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Handle of the next tree item. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetParent() Returns the handle of an object's parent window. **Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetPrevItem(hItem) Gets the previous sibling tree item of the passed tree item handle. Returns 0 if there are no more sibling items. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Handle of the previous tree item. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetProperty(name, value) | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------- | ----------- | | **name** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **value** | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetProperty(name) Gets the value of a named property. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ----------- | | **name** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetSelectedItem() Returns the handle to the selected tree item, or 0 if no item is selected. **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Handle to the selected tree item, or 0 if no item is selected. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetSize(width, height) | Parameter | Type | Description | | ---------- | ---------------------------------------------------------------------------------------- | ----------- | | **width** | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **height** | [SalNumber&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetText(text, maxLen) | Parameter | Type | Description | | ---------- | ---------------------------------------------------------------------------------------- | ----------- | | **text** | [SalString&](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **maxLen** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetText(maxLen) Retrieves the text of a window. | Parameter | Type | Description | | ---------- | --------------------------------------------------------------------------------------- | ----------- | | **maxLen** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetWindowColor(colorIndex) Gets a window's color. | Parameter | Type | Description | | -------------- | --------------------------------------------------------------------------------------- | ----------- | | **colorIndex** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)GetWindowState() Returns a window's current state. **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)HideWindow() Hides a window. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)HideWindowAndLabel() Hides a window and its associated label. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)InsertItem(hItem, nIndex, sTitle) Inserts a tree item into the tree control. The new item will be a child of *hItem* . If *hItem* is 0, the tree item is added as a top level child of the tree control. If *nIndex* is greater than or equal to the number of child items, or if *nIndex* is less than zero, the new item is appended. | Parameter | Type | Description | | ---------- | --------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle of the tree item which will be the parent of the new item. | | **nIndex** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Index to insert (starting at zero). | | **sTitle** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Title of the new item. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Handle of the newly created item. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)InvalidateWindow() Causes a window to be repainted. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)IsDerivedFromClass(typeClass) Determines whether a window is an instance of the specified class. | Parameter | Type | Description | | ------------- | --------------------------------------------------------------- | ----------- | | **typeClass** | [Type](https://docs.microsoft.com/en-us/dotnet/api/system.type) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)IsEnabled() Determines whether a window is enabled for mouse and keyboard input. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)IsModified() Returns the setting of the Field Edit Flag for a data field, multi line field, combo box, table window's context row cell, or picture. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)IsVisible() Determines whether a window is currently visible. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ItemHasCheckBox(hItem) Returns true if the tree item has a checkbox displayed. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the item has a checkbox displayed, FALSE if not. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ItemIsChecked(hItem) Returns true if the item checkbox is checked. Returns false if the checkbox is not displayed. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the checkbox is checked. If the checkbox is not checked, or is not displayed, bIsChecked is FALSE. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ItemIsExpanded(hItem) Returns whether the item is expanded. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the item is expanded, FALSE if not. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ItemIsSelected(hItem) Returns whether the item is selected. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the item is selected, FALSE if not. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ItemsHaveCheckBoxes() Returns true if the tree shows checkboxes next to the items. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the items have a checkbox displayed, FALSE if not. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)KillTimer(idEvent) Destroys an object's system timer. | Parameter | Type | Description | | ----------- | --------------------------------------------------------------------------------------- | ----------- | | **idEvent** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)MoveDownItem(hItem) Moves a tree item downward. This functions fails if the tree item is the last child of its parent. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)MoveItem(hItem, hParentItem, nPosition) Moves a tree node and all its sub-nodes to a new location in the tree control. | Parameter | Type | Description | | --------------- | --------------------------------------------------------------------------------------- | -------------------------------------------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **hParentItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the new parent tree item. | | **nPosition** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Position in the new parents list of children to place the new child (0-n). | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)MoveUpItem(hItem) Moves a tree item upward . This functions fails if the tree item is the first child of its parent. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)MoveWindow(xOffset, yOffset) Moves a window a given number of form units on the X and Y axes relative to its current position. | Parameter | Type | Description | | ----------- | --------------------------------------------------------------------------------------- | ----------- | | **xOffset** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **yOffset** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)PixelsToFormUnits(numPixels, vertical) Computes the number of form units based on the number of pixels. Form units are a unit of measurement used by functions that move and position objects. Form units are computed using physical units (pixels) in conjunction with a window's font sizes. | Parameter | Type | Description | | ------------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------- | | **numPixels** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **vertical** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | If the form units are on the X axis, set this parameter to FALSE. If the form units are on the Y axis, set this parameter to TRUE. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)PostMessage(msg, mywParam, mylParam) Posts the specified message to a window by adding nMsg to hWndReceiver's message queue. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ----------- | | **msg** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **mywParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **mylParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)PromoteItem(hItem) Moves a tree item so it becomes the sibling of its parent. This functions fails if the tree item has no grandparent. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)Reset(bRemove) Clears a tree control with the option to retain or destroy design-time nodes. | Parameter | Type | Description | | ----------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- | | **bRemove** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | TRUE = Remove all nodes. FALSE = Remove nodes created dynamically; the tree goes back to the initial state. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it does not succeed. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SendMessage(msg, mywParam, mylParam) Sends the specified message to a window. SalSendMsg does not return until the processing for the message is complete. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ----------- | | **msg** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **mywParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **mylParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SendMessageToChildren(msg, mywParam, mylParam) Sends a message to all child items of a form window, dialog box, table window, or MDI window. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ----------- | | **msg** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **mywParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **mylParam** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetContextMenu(sMenuName, nFlags) Defines a named popup menu that displays automatically when a window receives SAM\_ContextMenu. | Parameter | Type | Description | | ------------- | --------------------------------------------------------------------------------------- | ----------- | | **sMenuName** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **nFlags** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetContextMenu(menuType, flags) Defines a named popup menu that displays automatically when a window receives SAM\_ContextMenu. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ----------- | | **menuType** | [Type](https://docs.microsoft.com/en-us/dotnet/api/system.type) | | | **flags** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetCursor(resource, type) Sets a window's cursor. | Parameter | Type | Description | | ------------ | ----------------------------------------------------------------------------------------------- | ----------- | | **resource** | [SalResourceCursor](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **type** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetCursor(resourceId, type) Sets a window's cursor. | Parameter | Type | Description | | -------------- | --------------------------------------------------------------------------------------- | ----------- | | **resourceId** | [Int32](https://docs.microsoft.com/en-us/dotnet/api/system.int32) | | | **type** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetCursor(blob, type) Sets a window's cursor from a string variable. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ----------- | | **blob** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **type** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetCursorFile(file, type) Sets an application-defined cursor for the specified window. Use this function to set the cursor from an image stored in a file. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ----------- | | **file** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **type** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetFocus() Sets the focus to a specified window. **Returns:** [SalWindowHandle](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetFont(name, size, enhancement) Sets a window's font, font size, and font enhancements. | Parameter | Type | Description | | --------------- | --------------------------------------------------------------------------------------- | ----------- | | **name** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **size** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **enhancement** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemChecked(hItem, bChecked) Sets or clears the checkbox. If the checkbox is not displayed, this function has no effect. | Parameter | Type | Description | | ------------ | ---------------------------------------------------------------------------------------- | ------------------------------------------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **bChecked** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | TRUE to set the box as checked, FALSE to clear the checkbox. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemData(hItem, nValue) Sets the numeric value of the tree item. | Parameter | Type | Description | | ---------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **nValue** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Value to set. | **Returns:** [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). Value that was previously assigned to the tree item. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemEditable(hItem, bEditable) Sets whether the tree item's label can be edited. If bEditable is true, the label can be edited. | Parameter | Type | Description | | ------------- | ---------------------------------------------------------------------------------------- | ------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **bEditable** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Whether to enable or disable editing. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemFontEnh(hItem, nFontEnh) Sets the font enhancement for a tree item. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **nFontEnh** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Font mask. Combine the following: [FONT\_EnhDefault](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol), [FONT\_EnhNormal](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol), [FONT\_EnhItalic](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol), [FONT\_EnhUnderline](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol), [FONT\_EnhBold](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemImage(hItem, bSelected, sImageFile) Sets the image of a tree item. If the *bSelected* parameter is true, the selected image is set; otherwise the non-selected image is set. | Parameter | Type | Description | | -------------- | ---------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **bSelected** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | If TRUE, use selected image. If FALSE, use non-selected image. | | **sImageFile** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Filename of the image. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemImageFromBinary(hItem, bSelected, nFormat, bPicture) Sets the image of a tree item. If the *bSelected* parameter is true, the selected image is set; otherwise the non-selected image is set. | Parameter | Type | Description | | ------------- | ---------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **bSelected** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | If TRUE, use selected image. If FALSE, use non-selected image. | | **nFormat** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | The format of the picture contents: [PIC\_FormatBitmap](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol), [PIC\_FormatIcon](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol), [PIC\_FormatObject](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **bPicture** | [SalBinary](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | The image data to be assigned to the tree node. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemImageFromResource(hItem, bSelected, tResource) Sets the image of a tree item. If the *bSelected* parameter is true, the selected image is set; otherwise the non-selected image is set. | Parameter | Type | Description | | ------------- | ----------------------------------------------------------------------------------------- | -------------------------------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **bSelected** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | If TRUE, use selected image. If FALSE, use non-selected image. | | **tResource** | [SalResource](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Resource object. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemText(hItem, sText) Sets the title of the item. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | -------------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **sText** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Text to set as the title for this tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemTextColor(hItem, nColor) Sets the text color of the tree item. | Parameter | Type | Description | | ---------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **nColor** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Color to set. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetItemTooltip(hItem, sTooltip) Sets the tooltip for the tree item. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **sTooltip** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Tooltip text. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetLabelText(sText) Sets the text of the associated label control. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ----------- | | **sText** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetLocation(x, y) Moves a window to a new position (x, y) on the X and Y axes. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ----------- | | **x** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **y** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetModified(bSet) Sets or clears the field edit flag for an editable data field, combo box, multi line text field, table window column, or picture. | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------- | ----------- | | **bSet** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetProperty(name, value, length) Sets the value of a named property. | Parameter | Type | Description | | ---------- | --------------------------------------------------------------------------------------- | ----------- | | **name** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **value** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **length** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetSelectedItem(hItem) Selects a tree item. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ------------------------ | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetSize(width, height) Resizes a window. | Parameter | Type | Description | | ---------- | --------------------------------------------------------------------------------------- | ----------- | | **width** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **height** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetText(text) Sets the text of a window. | Parameter | Type | Description | | --------- | --------------------------------------------------------------------------------------- | ----------- | | **text** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetTimer(idEvent, elapseMilliSec) Creates a system timer for a given object. When a timer event occurs, sends SAM\_Timer messages to the object in specified intervals. Timers are a limited global resource. Your application must check the value returned by SalTimerSet to verify that the timer was created. | Parameter | Type | Description | | ------------------ | --------------------------------------------------------------------------------------- | ----------- | | **idEvent** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **elapseMilliSec** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)SetWindowColor(colorIndex, color) Sets a window's color. | Parameter | Type | Description | | -------------- | --------------------------------------------------------------------------------------- | ----------- | | **colorIndex** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **color** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ShowItemCheckBox(hItem, bShow) Shows or hides the checkbox for a tree item. | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------- | -------------------------------------------- | | **hItem** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | Handle to the tree item. | | **bShow** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | TRUE to show the checkbox, FALSE to hide it. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ShowItemsCheckBoxes(bShow) Shows or hides the checkboxes for the tree control. | Parameter | Type | Description | | --------- | ---------------------------------------------------------------------------------------- | ---------------------------------------------- | | **bShow** | [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | TRUE to show the checkboxes, FALSE to hide it. | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). TRUE if the function succeeds and FALSE if it fails. ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ShowWindow() Makes a window visible. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)ShowWindowAndLabel() Makes a window and its associated label visible. A label is the label control that immediately precedes the window in the outline. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)TrackPopupMenu(menuName, flags, x, y) Creates pop-up menus at runtime. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ----------- | | **menuName** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **flags** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **x** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **y** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)TrackPopupMenu(menuType, flags, x, y) Creates pop-up menus at runtime. | Parameter | Type | Description | | ------------ | --------------------------------------------------------------------------------------- | ----------- | | **menuType** | [Type](https://docs.microsoft.com/en-us/dotnet/api/system.type) | | | **flags** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **x** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **y** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)UpdateWindow() Forces the update of a window. **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)WinHelp(file, command, numData, strData) Starts the Windows help system. | Parameter | Type | Description | | ----------- | --------------------------------------------------------------------------------------- | ----------- | | **file** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **command** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **numData** | [SalNumber](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | | **strData** | [SalString](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | | **Returns:** [SalBoolean](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol). ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)Yield() Processes messages for this control. ## Events ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)MessageActions [SalMessageHandler](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) Message Actions ### ![](https://299326270-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F7qefdGDqaAibSgFIaGI0%2Fuploads%2Fgit-blob-2389c55cd19719a73a5ae98e1528c8dc8525cc35%2Finstance.png?alt=media)WindowActions [WindowActionsEventHandler](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) Window Actions ## Implements | Name | Description | | ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- | | [ISalControl](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | All SAL controls implement this interface. | | [ISalWindow](https://desktop-api.iceteagroup.com/ppj.runtime.49/controls/saltreecontrol) | All Sal windows (Child windows, Forms, Dialogs and MDIs) implement this interface. |