|
|
|
|
|
- Desplazamiento de un elemento sobre sí mismo
- Duplicados
- Criterio de ordenación
Mueve un elemento (hoja o nodo) en un control TreeView. También se desplazan todas las ramas emitidas desde este elemento. Ejemplo de control TreeView:
// Move the "Pineapple" leaf into the "Starters" node // in the "TREE_TVRecipe" control Res = TreeMoveItem(TREE_RecipeTV, ... "Recipes" + TAB + "Desserts" + TAB + "Fruit salad", ... "Recipes" + TAB + "Starters", tvFirst)
Sintaxis
<Result> = TreeMoveItem(<TreeView control> , <Source element> , <Destination element> [, <Sort mode>])
<Result>: booleano - True si el elemento se ha movido,
- False en caso contrario.
<TreeView control>: Nombre del control Nombre del control TreeView a utilizar. <Source element>: Cadena de caracteres Trayectoria del elemento (hoja o nodo) a desplazar. Este elemento y todas las ramas emitidas desde este elemento se moverán. Este parámetro tiene el siguiente formato:
"<Root name>" + TAB + ["<Name of 1st node>" + TAB + ... ["<Name of 2nd node>" + TAB + [...]]]"<Leaf name>" Si hay dos elementos con el mismo nombre en la ruta, puede añadir los ID de los elementos después de los nombres utilizando la función TreeID. <Destination element>: Cadena de caracteres Ruta del elemento (hoja o nodo) correspondiente al nuevo nodo "padre" del elemento desplazado. Este elemento debe existir. Este parámetro:- tiene el siguiente formato:
"<Root name>" + TAB + ["<Name of 1st node>" + TAB + ... ["<Name of 2nd node>" + TAB + [...]]]"<Leaf name>" Si hay dos elementos con el mismo nombre en la ruta, puede añadir los ID de los elementos después de los nombres utilizando la función TreeID. - corresponde a la constante NULL si el nodo "padre" es la raíz del control TreeView.
<Sort mode>: Constante o combinación de constantes opcional Posición del elemento desplazado en relación con los elementos "hijos" del nodo de destino. | | tvAcceptDuplicate | Se aceptan los duplicados (dos elementos del mismo nivel pueden tener el mismo nombre). El elemento desplazado se inserta por orden alfabético, entre los elementos del mismo nivel. | tvAlphaSort (Valor predeterminado) | El elemento desplazado se ordena alfabéticamente, entre los elementos del mismo nivel. | tvPrimera | El elemento se desplaza a la primera posición del nivel. | tvÚltima | El elemento se desplaza a la última posición del nivel. |
Observaciones Desplazamiento de un elemento sobre sí mismo Un elemento no puede desplazarse sobre sí mismo ni sobre uno de sus hijos. En este caso, TreeMoveItem devuelve Falso y el elemento no se mueve. Duplicados Pueden darse dos casos si <Destination element> ya contiene un hijo con el mismo nombre que <Source element>: - Si se aceptan los duplicados (constante tvAcceptDuplicate), el traslado se realiza de la forma habitual. la función TreeMoveItem devuelve True.
- Si no se aceptan duplicados, TreeMoveItem devuelve Falso. El elemento no se mueve.
Si <Source element> contiene duplicados con identificadores, estos duplicados se desplazan y conservan el mismo identificador. Criterio de ordenación El orden de prioridad de los parámetros para el modo de adición es el siguiente: - tvPrimera
- tvÚltima
- tvAlphaSort
Por ejemplo, en tvFirst + tvLast + tvAlphaSort, sólo se tiene en cuenta y se ejecuta la constante tvFirst.
Esta página también está disponible para…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|