ListBoxEx.SearchBarSetBackColor

Buenas amigos seguimos con la colección de tutoriales de plugins, hoy toca ListBoxEx Object
Plugin este plugin a diferencia de los “Actions Plugins” es visual y sus función básica es crear una
lista dentro de un espacio delimitado, como bien dice su nombre “ListBoxEx”, este objeto es
parecido a ListBox normal que trae el Autoplay Media Studio por defecto. Las posibilidades de
ListBoxEx son muchísimas gracias a su magnifico diseño y a sus muchos comandos y eventos.
Este plugin a sido creado por www.amsplugins.com y bajo una licencia comercial, “The ListBoxEx
plugin is copyright © 2008 Reteset.” si detectáis algún problema poneros en contacto con el creador
en esta dirección de mail [email protected] recuerda escribir el mail en ingles. Este tutorial
esta basado en la versión 2.1.0.0. aun que es una actualizacion de la version 1.4 a la 2.1. Para
descargarlo en la pagina anteriormente nombrada encontrareis versiones mas actual. Para mas
información visitar la pagina web del creador.
Las acciones de este objeto se dividen en 4 grupos:
4 MessageBar (Barra de Mensaje) + 6 SearchBar (Barra de búsqueda) +
23 Apperange (Apariencia) + 52 General.
ListBoxEx object plugin tiene 85 acciones practicas que son estas:
Barra de Mensaje
ListBoxEx.MessageBarShow
ListBoxEx.MessageBarSetColor
ListBoxEx.MessageBarVisible
ListBoxEx.MessageBarHide
Barra de Búsqueda
ListBoxEx.SearchBarGetText
ListBoxEx.SearchBarIsActive
ListBoxEx.SearchBarSetBackColor
ListBoxEx.SearchBarSetButton
ListBoxEx.SearchBarSetText
ListBoxEx.SearchBarShow
Apariencia
ListBoxEx.SetRaisedEdges
ListBoxEx.SetItemHGradientStyle
ListBoxEx.SetItemHColor
ListBoxEx.GetRaisedEdges
ListBoxEx.GetItemHGradientStyle
ListBoxEx.GetItemHColor
ListBoxEx.SetCursor
ListBoxEx.GetItemGradientStyle
ListBoxEx.SetItemGradientStyle
ListBoxEx.SetStyle
ListBoxEx.SetMask
ListBoxEx.SetItemIcon
ListBoxEx.SetItemColor
ListBoxEx.SetDefaultFont
ListBoxEx.SetColors
ListBoxEx.SetCheckBoxImages
ListBoxEx.ReplaceIcon
ListBoxEx.Redraw
ListBoxEx.GetStyle
ListBoxEx.GetItemColor
ListBoxEx.GetColors
ListBoxEx.CreateImageList
ListBoxEx.AddIcon
General
ListBoxEx.SetCheckListStyle
ListBoxEx.SetAcceptFiles
ListBoxEx.GetCheckListStyle
ListBoxEx.GetDroppedFiles
ListBoxEx.GetAcceptFiles
ListBoxEx.FindData
ListBoxEx.GetItemDataEx
ListBoxEx.SetItemDataEx
ListBoxEx.GetItemVisible
ListBoxEx.SetItemVisible
ListBoxEx.SetPos
ListBoxEx.SetSize
ListBoxEx.GetPos
ListBoxEx.GetSize
ListBoxEx.SetUpdate
ListBoxEx.CheckAllItems
ListBoxEx.IsVisible
ListBoxEx.IsEnabled
ListBoxEx.SetVisible
ListBoxEx.SetEnabled
ListBoxEx.GetTotalItems
ListBoxEx.DeleteAllItems
ListBoxEx.Find
ListBoxEx.SelectItem
ListBoxEx.SelectNone
ListBoxEx.GetItemText
ListBoxEx.EnsureVisible
ListBoxEx.DeleteItem
ListBoxEx.GetItemCheck
ListBoxEx.GetItemData
ListBoxEx.SetItemCheck
ListBoxEx.SetItemText
ListBoxEx.GetSelectedItem
ListBoxEx.SetItemData
ListBoxEx.GetCheckedItems
ListBoxEx.IsItemCheckBoxVisible
ListBoxEx.AddIconEx
ListBoxEx.GetItemIconSize
ListBoxEx.SetItemIconSize
ListBoxEx.SetItemCheckBoxVisible
ListBoxEx.Sort
ListBoxEx.MoveItem
ListBoxEx.SwapItems
ListBoxEx.EnumModuleIcons
ListBoxEx.IsTooltipsVisible
ListBoxExSetTooltipsVisible
ListBoxEx.SetTooltipProperties
ListBoxEx.GetTooltipProperties
ListBoxEx.SetItemTooltipText
ListBoxEx.GetItemTooltipText
ListBoxEx.InsertItem
ListBoxEx.AddItem
Este objeto también contiene propiedades y eventos especiales que serán descritas en la
sección de Propiedades, y en la sección de Eventos de este manual. Al final de este manual
estan las secciones de Lista de Comando HTML y una sección extra llamada Ejemplos que
son ejemplos prácticos mas extensos usando todos los comandos necesarios, para que
aprendas los entresijos de ListBoxEx.
Propiedades
Back Color
Especifica el color de fondo del objeto de ListBoxEx. usted puede seleccionar un color vía el
recolector en color.
Item Color
Especifica el color de los artículos del objeto de ListBoxEx. usted puede seleccionar un color vía el
recolector en color.
Selected Color
Especifica el color de fondo del artículo seleccionado en un objeto de ListBoxEx. usted puede
seleccionar un color vía el recolector en color.
Grid Color
Especifica el color de las lineas que separas los artículos del objeto de ListBoxEx. usted puede
seleccionar un color vía el recolector en color.
CheckList Style
ListBoxEx de Juegos como una lista de comprobaciones, Cuando este usuario permitido puede
comprobar o no comprobar artículos vía el chasquido en todas partes del artículo. Artículos de
conversos de Simly ListBoxEx a checkboxes individual. Nota: Cuando este estilo sólo es permitido
'En CheckBox' fuegos de acontecimiento entonces el usuario selecciona un artículo.
DragAndDrop
Especifica si se puede o no arrastrar items al ListBoxEx.
RisedEdges
Especifica si se deseas ver los bordes elevados o no en el ListBoxEx.
Check Boxes
Especifica si los check boxes son visibles o invisibles.
Grid Lines
Especifica si las lineas “Grid” son visibles o invisibles.
Icons
Especifica si los iconos son visibles o invisibles.
Border Style
Especifica el estilo del borde del objeto de ListBoxEx. Puedes seleccionar entre esta tabla.
TABLA
None
Flat
DESCRIPCIÓN
Sin borde.
Una linea de borde.
Sunken
El borde hundido
Bevel
El borde elevado.
Show ToolTips
Especifica si deseas mostrar o no los tooltips en los articulos del ListBoxEx.
ToolTips Text Color
Especifica el color de los textos de los tooltips.
BackColorBegin
Especifica el color de fondo del inicio de los tooltips.
BackColorMiddle
Especifica el color de fondo del medio de los tooltips.
BackColorEnd
Especifica el color de fondo del final de los tooltips.
Max ToolTip Width
Especifica la anchura maxima de la ventana de los tooltips.
Eventos
On Create
Cuando es la creación de objeto: la lista de imagen de juego y el objeto diseñan en este tiempo.
On Enter
Cuando el ratón entra en el Objeto.
On Leave
Cuando el ratón deja de estar en el Objeto.
On Select
Cuando un usuario selecciona un ítem del Objeto.
e_Index:
(number) El indice del articulo que es seleccionado.
On CheckBox
Cuando el usuario chequea o no chequea, un ítem del ChekBox.
e_Index:
(number) El indice del articulo que es seleccionado.
e_Checked:
(boolean) El estado del checkbox. Si el argumento es true el ítem del checkbox esta chequeado
y si esta false el ítem del checkbox no esta chequeado
On DoubleClick
Cuando el usuario hace doble click en un ítem.
e_Index:
(number) El indice del articulo que es seleccionado.
On RightClick
Cuando el usuario hace click con el botón derecho en un ítem.
e_Index:
(number) El indice del articulo que es seleccionado.
On Focus
Cuando el objecto consigue el focus introducido.
On MB-LeftClick
Cuando el usuario hace click con el botón izquierdo en la barra de mensaje.
On MB-RightClick
Cuando el usuario hace click con el botón derecho en la barra de mensaje.
On SearchBtn
Cuando el usuario pulsa el el botón de búsqueda.
On DopFiles
Cuando el usuario arrastra Archivos/Carpetas sobre el ListBoxEx, si arrastrar y dejar esta activado.
e_Count:
(number) El numero de artículos dejados caer por el usuario(siempre superior que cero).
On LinkClk
Cuando el usuario hace click en un enlace.
e_Url:
(string) El string que especifica el href del nombre del enlace.
On TTLinkClk
Cuando el usuario hace click en un enlace de un tooltip.
e_Url:
(string) El string que especifica el href del nombre del enlace del tooltip.
Barra de Mensaje
ListBoxEx.MessageBarShow
ListBoxEx.MessageBarShow es para mostrar un mensaje en la parte superior del ListBoxEx Object.
ListBoxEx.MessageBarShow(ObjectName, Text, IconID, CloseButton, WrapText)
ObjectName: El nombre del Objecto.
Text: Texto que se mostrara en la MessageBar.
IconID: Icono de Mensaje que sera mostrado en la MessageBar.
VALOR
DESCRIPCION
-1
Sin Icono.
0
Icono de Stop.
1
Icono de Pregunta.
2
Icono de Exclamación.
3
Icono de información.
CloseButton: Si es true el botón de cerrar sera visible, y si es false entonces no sera visible.
WrapText: Si es true la barra sera re dimensionada hacia abajo si no cabe en una sola linea, y si es
false se mostrara todo el texto posible y al final se mostraran unos puntos para mostrar que el texto
es superior a la superficie, y si pones el ratón sobre la barra se mostrara todo el texto en el tooltip.
Returns: Si el resultado es true funciona, y si es false entonces es que falla.
Ejemplo:
if not (Install) then
ListBoxEx.MessageBarShow("Plugin1", "La instalación de la aplicación fallo.", 2, false, true);
else
ListBoxEx.MessageBarShow("Plugin1", "La instalación finalizo correctamente.", 3, true, true);
end
ListBoxEx.MessageBarSetColor
ListBoxEx.MessageBarSetColor es para seleccionar los colores de fondo y del texto del
MessageBar.
ListBoxEx.MessageBarSetColor(ObjectName, Back, BackHilete, Text, TextHilte)
ObjectName: El nombre del Objecto.
Back: Color de fondo del MessageBar (Numero Decimal).
BackHilete: Color de fondo del MessageBar al pasar por encima con el ratón (Numero Decimal).
Text: Color del texto que se muestra en el MessageBar (Numero Decimal).
TextHilte: Color del texto que se muestra en el MessageBar al pasar por encima con el mouse
(Numero Decimal).
Ejemplo:
ListBoxEx.MessageBarShow("Plugin1", "Ejemplo de Color de Fondo y de Texto usando El
comando MessageBarSetColors.", 1, true, true);
ListBoxEx.MessageBarSetColors("Plugin1", 0, 16777215, 16777215, 0);
ListBoxEx.MessageBarVisible
ListBoxEx.MessageBarVisible determina cuando la MessageBar es visible o no es visible.
ListBoxEx.MessageBarVisible(ObjectName)
ObjectName: El nombre del Objecto.
Returns: Si el resultado es true la MessageBar es visible, y si es false entonces no es visible.
Ejemplo:
result = ListBoxEx.MessageBarIsVisible("Plugin1");
ListBoxEx.MessageBarHide
ListBoxEx.MessageBarHide es para esconder el mesaje en la parte superior del objeto
ListBoxEx.MessageBarHide(ObjectName)
ObjectName: El nombre del Objecto.
Ejemplo:
if (error) then
ListBoxEx.MessageBarShow("Plugin1", "Se a producido un error en la Aplicación.", 1, true, true);
else
ListBoxEx.MessageBarHide("Plugin1");
end
Barra de Mensaje
ListBoxEx.SearchBarGetText
ListBoxEx.SearchBarGetText es para devolver el texto escrito en el input de la barra de búsqueda.
ListBoxEx.SearchBarGetText(ObjectName)
ObjectName: El nombre del Objecto.
Returns: Si el resultado es el texto que esta escrito en el input de la barra de búsqueda.
Ejemplo:
result = ListBoxEx.SearchBarGetText("Plugin1");
if result ~= "" then
Dialog.Message("Notice", result, MB_OK);
end
ListBoxEx.SearchBarIsActive
ListBoxEx.SearchBarIsActive es para saber si la barra de búsqueda esta activada o no.
ListBoxEx.SearchBarIsActive(ObjectName)
ObjectName: El nombre del Objecto.
Returns: Si el resultado es true la SearchBar esta activa, y si es false entonces no esta activa.
Ejemplo:
result = ListBoxEx.SearchBarIsActive("Plugin1");
if result == true then
Dialog.Message("Notice", "La Barra de Búsqueda esta activa.", MB_OK);
else
Dialog.Message("Notice", "La Barra de Búsqueda no esta activa.", MB_OK);
end
ListBoxEx.SearchBarSetBackColor
ListBoxEx.SearchBarSetBackColor para fijar el color de fondo de la barra de búsqueda.
ListBoxEx.SearchBarSetBackColor(ObjectName, BackColor)
ObjectName: El nombre del Objecto.
BackColor: El Color del fondo de la barra de búsqueda, en formato de tabla décima (acepta asta 30
colores).
Ejemplo:
ListBoxEx.SearchBarSetBackColor("Plugin1", {6723891, 65280});
ListBoxEx.SearchBarSetButton
ListBoxEx.SearchBarSetButton es para fijar el texto que deseas que se muestre en el boton de la
barra de busqueda.
ListBoxEx.SearchBarSetButton(ObjectName, Text, ButtonWidth)
ObjectName: El nombre del Objecto.
Text: El Texto que se mostrara en el botón de la barra de búsqueda.
ButtonWidth: Anchura del botón de la barra de búsqueda (por defecto 55).
Ejemplo:
ListBoxEx.SearchBarSetButton("Plugin1", "Buscar", 65);
ListBoxEx.SearchBarSetText
ListBoxEx.SearchBarSetText es para fijar el texto que deseas que se muestre en el input de la barra
de búsqueda.
ListBoxEx.SearchBarSetText(ObjectName, Text)
ObjectName: El nombre del Objecto.
Text: El Texto que se mostrara en el input de la barra de búsqueda.
Ejemplo:
ListBoxEx.SearchBarSetText("Plugin1", "Escribe aquí el texto que deseas buscar");
ListBoxEx.SearchBarShow
ListBoxEx.SearchBarShow es para mostrar o ocultar la barra de búsqueda en el ListBoxEx.
ListBoxEx.SearchBarShow(ObjectName, Show)
ObjectName: El nombre del Objecto.
Show: Si es true se mostrara la barra de búsqueda, y si es false no se mostrara.
Ejemplo:
ListBoxEx.SearchBarShow("Plugin1", true);
Apariencia
ListBoxEx.SetRaisedEdges
ListBoxEx.SetRaisedEdges es para delimitar con bordes elevados los items del el ListBoxEx.
ListBoxEx.SetRaisedEdges(ObjectName, Visible)
ObjectName: El nombre del Objecto.
Visible: Para hacer los bordes elevados true, para hacerlos normales false.
Ejemplo:
ListBoxEx.SetRaisedEdges("Plugin1", true);
ListBoxEx.SetItemHGradientStyle
ListBoxEx.SetItemHGradientStyle es para gestionar el estilo del degradado cuando pulsas sobre
determinado ítem indexado. Puedes seleccionar estilo: Vertical, Horizontal, y dos tipos de diagonal.
ListBoxEx.SetItemHGradientStyle(ObjectName, Index, Style)
ObjectName: El nombre del Objeto.
Index: Indice del ítem que desea modificar.
Style: El estilo del efecto de degradado cuando pulsas con el mouse.
CONSTANTE
VALOR
DESCRIPCIÓN
VERTICAL
0
Estilo vertical del degradado.
HORIZONTAL
1
Estilo horizontal del degradado.
BACKWARD_DIAGONAL
2
Estilo Backward diagonal del degradado.
FORWARD_DIAGONAL
3
Estilo Forward diagonal del degradado.
Ejemplo:
for IndexNum = 1, 150 do
ListBoxEx.SetItemHGradientStyle("Plugin1", IndexNum, HORIZONTAL);
end
ListBoxEx.SetItemHColor
ListBoxEx.SetItemHColor es para seleccionar el color de los items cuando se pulsa sobre ellos con
el mouse.
ListBoxEx.SetItemHColor(ObjectName, Index, HighlightColor)
ObjectName: El nombre del Objeto.
Index: Indice del item que desea modificar.
HighlightColor: Es para selecciona el color del degradado, cuando pulsas con el mouse. (Numero
Decimal). ”Nota: La tabla acepta asta 30 indices de color como máximo”
Ejemplo:
for IndexNum = 1, 150 do
ListBoxEx.SetItemHColor("Plugin1", IndexNum, {52479, 39423, 26367, 39423, 52479});
end
ListBoxEx.GetRaisedEdges
ListBoxEx.GetRaisedEdges es para conseguir el resultado sobre los bordes elevados de un objeto.
ListBoxEx.GetRaisedEdges(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Si el resultado es true los bordes elevados son visibles, y si es false entonces no.
Ejemplo:
Resultado = ListBoxEx.GetRaisedEdges("Plugin1")
ListBoxEx.GetItemHGradientStyle
ListBoxEx.GetItemHGradientStyle para consigue el estilo de degradado de cuando pulsas con el
mouse de un artículo en un objeto de ListBoxEx.
ListBoxEx.GetItemHGradientStyle(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: Indice del item que desea modificar.
Returns: Devuelve el estilo del objeto que puede ser VERTICAL(0), HORIZONTAL(1),
BACKWARD_DIAGONAL(2), FORWARD_DIAGONAL(3).
Ejemplo:
ResultadoDeStyle = ListBoxEx.GetItemHGradientStyle("Plugin1", 1);
ListBoxEx.GetItemHColor
ListBoxEx.GetItemHColor es para conseguir el color de un ítem cuando se pulsa sobre ellos con el
mouse.
ListBoxEx.GetItemHColor(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: Indice del ítem que desea modificar.
Returns: Devuelve el color del objeto en forma de una tabla numérica indexada que contiene el
valor (o valores) del color. Para recuperar un color especifico usar el metodo de indices como aquí
debajo se muestra. El error da como resultado el siguiente valor: nil.
Ejemplo:
result = ListBoxEx.GetItemHColor("Plugin1", 1);
sz_string = "";
if (result ~= nil) then
if (result[1] == -1) then
Dialog.Message("Notice", "This Item Uses Default Color..");
else
min = 1;
max = Table.Count(result);
for count = min, max do
sz_string = sz_string..result[count].."\r\n"
end
Dialog.Message("Notice", sz_string);
end
else
Dialog.Message("Notice", "Error..");
end
ListBoxEx.SetCursor
ListBoxEx.SetColor es para poner un cursor personalizado en el ListBoxEx.
ListBoxEx.SetColor(ObjectName, Cursor)
ObjectName: El nombre del Objeto.
Cursor: Ruta completa del archivo de cursor(si se deja en blanco se restaura el cursor por defecto).
Returns: Si el resultado es true se consigio con existo si es false significa que fallo.
Ejemplo:
result = ListBoxEx.SetCursor("Plugin1", _SourceFolder.."\\AutoPlay\\Icons\\WsNormal.cur");
ListBoxEx.GetItemGradientStyle
ListBoxEx.GetItemGradientStyle es para consegir el estilo del degradado de un item.
ListBoxEx.GetItemGradientStyle(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: Indice del item que desea.
Returns: Devuelve el estilo del objeto que puede ser VERTICAL(0), HORIZONTAL(1),
BACKWARD_DIAGONAL(2), FORWARD_DIAGONAL(3).
Ejemplo:
result = ListBoxEx.GetItemGradientStyle("Plugin1", 1);
if (result == 0) then
Dialog.Message("Info", "El estilo ("..result..") es VERTICAL.", MB_OK);
elseif (result == 1) then
Dialog.Message("Info", "El estilo ("..result..") es HORIZONTAL.", MB_OK);
elseif (result == 2) then
Dialog.Message("Info", "El estilo ("..result..") es BACKWARD_DIAGONAL.", MB_OK);
elseif (result == 3) then
Dialog.Message("Info", "El estilo ("..result..") es FORWARD_DIAGONAL.", MB_OK);
end
ListBoxEx.SetItemGradientStyle
ListBoxEx.SetItemGradientStyle es para gestionar el estilo del degradado.Puedes seleccionar estilo:
Vertical, Horizontal, y dos tipos de diagonal.
ListBoxEx.SetItemGradientStyle(ObjectName, Index, Style)
ObjectName: El nombre del Objeto.
Index: Indice del ítem que desea.
Style: El estilo del efecto de degradado cuando pulsas con el mouse.
CONSTANTE
VALOR
DESCRIPCIÓN
VERTICAL
0
Estilo vertical del degradado.
HORIZONTAL
1
Estilo horizontal del degradado.
BACKWARD_DIAGONAL
2
Estilo Backward diagonal del degradado.
FORWARD_DIAGONAL
3
Estilo Forward diagonal del degradado.
Ejemplo:
ListBoxEx.SetItemGradientStyle("Plugin1", 1, HORIZONTAL);
ListBoxEx.SetStyle
ListBoxEx.SetStyle pone un estilo al ListBoxEx.
ListBoxEx.SetStyle(ObjectName, Style)
ObjectName: El nombre del Objeto.
Style: La tabla de estilos indexada: Icons , Grid , CheckBoxes.
TABLA
DESCRIPCIÓN
Icons
Si seleccionas true los iconos son visibles, y si es false entonces no.
Grid
Si seleccionas true las rejillas son visibles, y si es false entonces no.
CheckBoxes Si seleccionas true los CheckBoxs son visibles, y si es false entonces no.
Ejemplo:
ListBoxEx.SetStyle("Plugin1", {Icons = true, Grid = true, CheckBoxes = true});
ListBoxEx.SetMask
ListBoxEx.SetMask este comando es para usar una mascara personalizada con transparencia.
ListBoxEx.SetMask(ObjectName, MaskFile, FitToWindow, TransparentColor)
ObjectName: El nombre del Objeto.
MaskFile: Ruta completa del archivo de mascara para transparencia.
FitToWindow: Si seleccionas true la mascara se fijara usando el tamaño del ListBoxEx, si
seleccionas false la mascara se mostrara a tamaño real.
TransparentColor: El color que representa la transparencia de la mascara.
Ejemplo:
ListBoxEx.SetMask("Plugin1", "AutoPlay\\Images\\630_22.png", true, 0);
ListBoxEx.SetItemIcon
ListBoxEx.SetItemIcon es para poner un nuevo icono para el artículo que es especificado con el
índice de artículo.
ListBoxEx.SetItemIcon(ObjectName, Index, IconIndex)
ObjectName: El nombre del Objeto.
Index: Indice del ítem que desea.
IconIndex: El indice del icono que deseas usar.
Ejemplo:
ListBoxEx.SetItemIcon("Plugin1", 1, 1);
ListBoxEx.SetItemColor
ListBoxEx.SetItemColor es para fijar el color de un ítem del ListBoxEx.
ListBoxEx.SetItemColor(ObjectName, Index, ItemColor)
ObjectName: El nombre del Objeto.
Index: Indice del ítem que desea.
ItemColor: El color que deseas fijar como color del objeto.
Notas: el ItemColor es una tabla y es necesario fijar {corchetes} para los color que quieras usar.
Si la tabla de colores contiene mas de un color se creara un degradado.
Si la tabla contiene nil se usara el color predeterminado.
Ejemplo 1:
– El Color de fondo sera seleccionado usando ShellDialogs.ChooseColor
SelectColor = ShellDialogs.ChooseColor();
if (SelectColor ~= nil) then
ListBoxEx.SetItemColor("Plugin1", 1, {SelectColor.Dec});
end
Ejemplo 2:
-- El color de fondo del articulo sera un degradado de 3 colores.
ListBoxEx.SetItemColor("Plugin1", 1, {16316664,16764057,16764057});
Ejemplo 3:
-- El color de fondo del articulo sera rojo.
ListBoxEx.SetItemColor("Plugin1", 1, {255});
Ejemplo 4
-- Se fijara el color predeterminado de fondo.
ListBoxEx.SetItemColor("Plugin1", 1, nil);
ListBoxEx.SetColors
ListBoxEx.SetColors es para cambiar los colores del fondo, items, lineas, etc del ListBoxEx.
ListBoxEx.SetColors(ObjectName, Back, Items, Selection, Grid)
ObjectName: El nombre del Objeto.
Back: El color de fondo del ListBoxEx (usa -1 para ignorar).
Items: El color de fondo de los items del ListBoxEx (usa -1 para ignorar).
Selection: El color de fondo de ítem seleccionado del ListBoxEx (usa -1 para ignorar).
Grid: El color de las lineas que separan los items del ListBoxEx (usa -1 para ignorar).
Ejemplo:
ListBoxEx.SetColors("Plugin1", 26367, 13209, 52377, 16776960);
ListBoxEx.SetCheckBoxImages
ListBoxEx.SetCheckBoxImages es para cambiar los checkbox por uno personalizado.
ListBoxEx.SetCheckBoxImages(ObjectName, Back, ImageList, TransparentColor)
ObjectName: El nombre del Objeto.
ImageList: La ruta completa del archivo que contiene la lista de imágenes( soporta una imagen de
tamaño 32x16 partida en dos partes de 16x16)
TransparentColor: El color que sera transparente de la lista de imágenes.
Ejemplo:
ListBoxEx.SetCheckBoxImages("Plugin1", "AutoPlay\\Images\\pins.bmp", 16711935);
ListBoxEx.Redraw
ListBoxEx.Redraw es para volver a dibujar el ListBoxEx.
ListBoxEx.Redraw(ObjectName)
ObjectName: El nombre del Objeto.
Ejemplo:
ListBoxEx.Redraw("Plugin1");
ListBoxEx.GetStyle
ListBoxEx.GetStyle es para conseguir los parámetros del estilo del ListBoxEx.
ListBoxEx.GetStyle(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Devuelve la tabla indexada del estilo de Icons, Grid, CheckBoxes. Si devuelve returns nil
ocurre el error.
TABLA
DESCRIPCIÓN
Icons
Si seleccionas true los iconos son visibles, y si es false entonces no.
Grid
Si seleccionas true las rejillas son visibles, y si es false entonces no.
CheckBoxes Si seleccionas true los CheckBoxs son visibles, y si es false entonces no.
Ejemplo:
tblStyle = ListBoxEx.GetStyle("Plugin1");
if (tblStyle ~= nil) then
if (tblStyle.CheckBoxes == true) then
Dialog.Message("Notice", "Check Boxes Are Visible");
end
end
ListBoxEx.GetItemColor
ListBoxEx.GetItemColor consige el color de un ítem del ListBoxEx.
ListBoxEx.GetItemColor(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: Indice del ítem que desea.
Returns: Devuelve una tabla numérica con índice que contiene el valor (o valores) en color
el articulo especificado usa como resultado de vuelta de color [] = -1. si ocurre un error el valor que
devuelve es nil.
Ejemplo:
result = ListBoxEx.GetItemColor("Plugin1", 2);
sz_string = "";
if (result ~= nil) then
if (result[1] == -1) then
Dialog.Message("Notice", "This Item Uses Default Color..");
else
min = 1;
max = Table.Count(result);
for count = min, max do
sz_string = sz_string..result[count].."\r\n"
end
Dialog.Message("Notice", sz_string);
end
else
Dialog.Message("Notice", "Error..");
end
ListBoxEx.GetColors
ListBoxEx.GetColors es para saber los colores del fondo, los items, etc.. del ListBoxEx.
ListBoxEx.GetColors(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Devuelve una tabla indexada con el resultado de Back , Items , Selection , Grid.
TABLA
DESCRIPCIÓN
Back
Color de fondo.
Items
Color del ítem.
Selection Color del ítem seleccionado.
Grid
Color de la linea que separa los ítems del ListBoxEx.
Ejemplo:
FG = ListBoxEx.GetColors("Plugin1");
if (FG ~= nil) then
Dialog.Message("Notice", "Decimal Back Color Value Of Plugin Is : "..FG.Back);
-- También puedes cargar el mismo dialogo usando los otros valores que son:
-- FG.Items, FG.Selection, FG.Grid
end
ListBoxEx.CreateImageList
ListBoxEx.CreateImageList es para crear un a lista imágenes para el ListBoxEx.
Nota: Este comando solo se puede cargar una vez. Es recomendable usarlo solo en la sección
de eventos de “On Create”.
ListBoxEx.CreateImageList(ObjectName, Size, BitDepth)
ObjectName: El nombre del Objeto.
Size: El tamaño del icono en la lista de imágenes. Como valores predefinidos vienen 16,32,48,64
pero se pueden usar una resolución superior.
BitDepth: Calidad en Bits de la imagen o icono. Como valores predefinidos vienen BIT_4,
BIT_8, BIT_16, BIT_24, BIT_32.
Returns: Si el resultado es true funciona, y si es false entonces es que falla.
Ejemplo:
bImagelist = ListBoxEx.CreateImageList("Plugin1", 35, BIT_32);
if ( bImagelist ) then
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icon.ico");
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icon2.ico");
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icon3.ico");
end
ListBoxEx.AddIcon
ListBoxEx.AddIcon añade un icono a una lista de imagen antes creada.
ListBoxEx.AddIcon(ObjectName, Icon)
ObjectName: El nombre del Objeto.
Icon: El ruta completa del archivo de icono.
Returns: Devuelve índice del último icono añadido, si un error ocurre que el valor de vuelta es -1.
Ejemplo:
bImagelist = ListBoxEx.CreateImageList("Plugin1", 35);
if ( bImagelist ) then
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icon.ico");
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icon2.ico");
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icon3.ico");
ListBoxEx.SetImageList("Plugin1");
end
General
ListBoxEx.SetCheckListStyle
ListBoxEx.SetCheckListStyle es para activar o desactivar el CheckListStyle que es para poder
identificar items atraves de la sección de eventos. Nota: cuanto el estilo esta activado los eventos de
la selecciones “On CheckBox” nos posibles de usar.
ListBoxEx.SetCheckListStyle(ObjectName, Enable)
ObjectName: El nombre del Objeto.
Enable: Si seleccionas true se podrán arrastrar archivos al ListBoxEx, y si es false entonces no.
Ejemplo:
ListBoxEx.SetCheckListStyle("Plugin1", true);
ListBoxEx.SetAcceptFiles
ListBoxEx.SetAcceptFiles es para activar o desactivar la opción de arrastrar y dejar sobre el
ListBoxEx (por defecto esta opción esta desactivada).
ListBoxEx.SetAcceptFiles(ObjectName, Enable)
ObjectName: El nombre del Objeto.
Enable: Si seleccionas true se podrán arrastrar archivos al ListBoxEx, y si es false entonces no.
Ejemplo:
ListBoxEx.SetAcceptFiles("Plugin1", true); -- Enable Drag And Drop
ListBoxEx.GetCheckListStyle
ListBoxEx.GetCheckListStyle es para comprobar si el CheckListStyle esta activo o no.
ListBoxEx.GetCheckListStyle(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Si el resultado es true se que CheckListStyle esta activo, y si es false entonces no.
Ejemplo:
result = ListBoxEx.GetCheckListStyle("Plugin1");
ListBoxEx.GetDroppedFiles
ListBoxEx.GetDroppedFiles es para devolver una tabla numérica indexada que contiene la ruta de
los archivos/carpetas que se han arrastrado al ListBoxEx.
ListBoxEx.GetDroppedFiles(ObjectName, Enable)
ObjectName: El nombre del Objeto.
Clean: Si seleccionas true limpia la lista archivos arrastrados al ListBoxEx, y si es false la lista no
se limpiara cuando arrastre el siguiente archivo al ListBoxEx.
Returns: Devuelve una tabla numérica indexada que contiene la ruta de los archivos/carpetas que el
usuario a arrastrado al ListBoxEx. Si el resultado es nil la lista estará no operativa.
Ejemplo:
tblDropList = ListBoxEx.GetDroppedFiles("Plugin1", true);
if (tblDropList ~= nil ) then
for j, file_path in tblDropList do
ListBoxEx.InsertItem("Plugin1", file_path, file_path, nIconIndex, HTML, 0, nil, nil);
end
end
ListBoxEx.GetAcceptFiles
ListBoxEx.GetAcceptFiles es para mostrar si el ListBoxEx acepta arrastrar archivos a este.
ListBoxEx.GetAcceptFiles(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Si el resultado es true se posible arrastrar archivos al ListBoxEx,y si es false entonces no.
Ejemplo:
result = ListBoxEx.GetAcceptFiles("Plugin1");
ListBoxEx.FindData
ListBoxEx.FindData encuentra el texto especificado en campos de Exdatos o Datos de artículos
ListBoxEx.
ListBoxEx.FindData(ObjectName, Text, Field)
ObjectName: El nombre del Objeto.
Text: El texto que desea buscar.
Field: El campo en el que se buscara.
CONSTANTE
VALOR
DESCRIPCIÓN
FIND_DATA
0
Encuentra el texto en campos de datos.
FIND_EXDATA
1
Encuentra el texto en campos de datos suplementarios.
Returns: devuelve una tabla numérica indexada que contiene el numero de veces que fue
encontrado el texto especificado. Si el resultado es nil el texto especificado no fue encontrado.
Ejemplo:
found_items = ListBoxEx.FindData("Plugin1", "Hello" , FIND_DATA);
if (found_items ~= nil) then
ListBoxEx.EnsureVisible("Plugin1", found_items[1]);
ListBoxEx.SelectItem("Plugin1", found_items[1], true);
end
ListBoxEx.GetItemDataEx
ListBoxEx.GetItemDataEx es para consigue los datos suplementarios del artículo especificado en
un objeto de ListBoxEx.
ListBoxEx.GetItemDataEx(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Returns: devuelve el dato suplementario del ítem si existe. El fallo bien cuando devuelve el string
vació “”.
Ejemplo:
result = ListBoxEx.GetItemDataEx("Plugin1", 1)
if result ~= "" then
Dialog.Message("Notice", "El Dato suplementario es "..result, MB_OK);
end
ListBoxEx.SetItemDataEx
ListBoxEx.SetItemDataEx es para fijar datos suplementarios en los items del ListBoxEx.
ListBoxEx.SetItemDataEx(ObjectName, Index, ExtraData)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
ExtraData: Los nuevos datos suplementarios para artículo especificado.
Ejemplo:
result = ListBoxEx.SetItemDataEx("Plugin1", 1, "texto aqui")
ListBoxEx.GetItemVisible
ListBoxEx.GetItemVisible es para conseguir el estado visible o no, de un objeto.
ListBoxEx.GetItemVisible(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Returns: Si el resultado es true el ítem es visible, y si es false entonces no lo es.
Ejemplo:
result = ListBoxEx.GetItemVisible("Plugin1", 1);
ListBoxEx.SetItemVisible
ListBoxEx.SetItemVisible es para hacer visible o invisible un ítem del ListBoxEx.
ListBoxEx.SetItemVisible(ObjectName, Index, Visible)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Visible: Si seleccionas true el item es visible y si es false no es visible.
Ejemplo:
ListBoxEx.SetItemVisible("Plugin1", 1, true);
ListBoxEx.SetPos
ListBoxEx.SetPos es para fijar la posición del ListBoxEx dentro de proyecto.
ListBoxEx.SetPos(ObjectName, X, Y)
ObjectName: El nombre del Objeto.
X: Nueva posición X del objeto.
Y: Nueva posición Y del objeto.
Ejemplo:
ListBoxEx.SetPos("Plugin1", 4, 55);
ListBoxEx.SetSize
ListBoxEx.SetSize es para fijar el tamaño del ListBoxEx.
ListBoxEx.SetSize(ObjectName, Width, Height)
ObjectName: El nombre del Objeto.
Width: Nueva anchura del objeto.
Height: Nueva altura del objeto.
Ejemplo:
ListBoxEx.SetSize("Plugin1", 300, 200)
ListBoxEx.GetPos
ListBoxEx.GetPos es para devolver el resultado de la posición del ListBoxEx.
ListBoxEx.GetPos(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Devuelve una tabla con el resultado de X y Y. Si el resultado es nil ocurre error.
Ejemplo:
result = ListBoxEx.GetPos("Plugin1");
ListBoxEx.GetSize
ListBoxEx.GetSize es para devolver el resultado del tamaño del ListBoxEx.
ListBoxEx.GetSize(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Devuelve una tabla con el resultado de Width y Height. Si el resultado es nil ocurre
error.
Ejemplo:
result = ListBoxEx.GetSize("Plugin1");
ListBoxEx.SetUpdate
ListBoxEx.SetUpdate es para activar o desactivar la actualización del ListBoxEx. Cuando
actualizas el ListBoxEx se vuelven a introducir todos los items.
Nota: Cuando ListBoxEx.SetUpdate esta desactivado, cualquier cambio en el ListBoxEx no sera
visible asta que no se actualice el ListBoxEx con el comando SetUpdate activado.
ListBoxEx.SetUpdate(ObjectName, Enabled)
ObjectName: El nombre del Objeto.
Enabled: Es para activa o desactivar la actualización del ListBoxEx.
VALOR
DESCRIPCIÓN
true
Activa la actualización del ListBoxEx.
false
Desactiva la actualización del ListBoxEx.
Ejemplo:
ListBoxEx.SetItemCheckBoxVisible("Plugin1", 1, false);
ListBoxEx.SetUpdate("Plugin1", true);
ListBoxEx.CheckAllItems
ListBoxEx.CheckAllItems es para seleccionar o des-seleccionar todos los CheckBox.
ListBoxEx.CheckAllItems(ObjectName, Cheked)
ObjectName: El nombre del Objeto.
Cheked: true es para seleccionar todo los checkbox, y si es false para des-seleccionarlos.
Returns: Devuelve el numero de objetos chequeados.
Ejemplo:
result = ListBoxEx.CheckAllItems("Plugin1", true);
Dialog.Message("Notice", "Total "..result.." Item(s) Checked");
ListBoxEx.IsVisible
ListBoxEx.IsVisible determina si el ListBoxEx es visible o no.
ListBoxEx.IsVisible(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Si el resultado es true el ListBoxEx es visible, y si es false entonces no lo es.
Ejemplo:
result = ListBoxEx.IsVisible("Plugin1");
ListBoxEx.IsEnabled
ListBoxEx.IsEnabled determina si el ListBoxEx esta activo o no.
ListBoxEx.IsEnabled(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Si el resultado es true el ListBoxEx es activo, y si es false entonces no lo es.
Ejemplo:
result = ListBoxEx.IsEnabled("Plugin1")
ListBoxEx.SetVisible
ListBoxEx.SetVisible es para fijar la visibilidad del ListBoxEx.
ListBoxEx.SetVisible(ObjectName, Visible)
ObjectName: El nombre del Objeto.
Visible: Si seleccionas true el ListBoxEx es visible y si es false no es visible.
Ejemplo:
ListBoxEx.SetVisible("Plugin1", true);
ListBoxEx.SetEnabled
ListBoxEx.SetEnabled es para fijar si el ListBoxEx esta activo o no.
ListBoxEx.SetEnabled(ObjectName, Enable)
ObjectName: El nombre del Objeto.
Enable: Si seleccionas true el ListBoxEx es activado y si es false no estará activado.
Ejemplo:
ListBoxEx.SetEnabled("Plugin1", true);
ListBoxEx.GetTotalItems
ListBoxEx.GetTotalItems devuelve el numero de items que existen en el ListBoxEx.
ListBoxEx.GetTotalItems(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Devuelve el total de ítem en el ListBoxEx.
Ejemplo:
result = ListBoxEx.GetTotalItems("Plugin1")
if result ~= 0 then
Dialog.Message("Notice", "El Total de items es: "..result, MB_OK);
end
ListBoxEx.DeleteAllItems
ListBoxEx.DeleteAllItems elimina todos los items del ListBoxEx.
ListBoxEx.DeleteAllItems(ObjectName)
ObjectName: El nombre del Objeto.
Ejemplo:
ListBoxEx.DeleteAllItems("Plugin1");
ListBoxEx.Find
ListBoxEx.Find es para buscar un texto especifico.
ListBoxEx.Find(ObjectName, Text)
ObjectName: El nombre del Objeto.
Text: El texto que desea buscar.
Returns: Devuelve una tabla con el resultado del texto. Si el resultado es nil ocurre error.
Ejemplo:
inputR = Dialog.Input("Buscar", "Texto que deseas buscar:", "", MB_ICONNONE);
if inputR ~= "" then
found_items = ListBoxEx.Find("Plugin1", inputR);
if (found_items ~= nil) then
ListBoxEx.EnsureVisible("Plugin1", found_items[1]);
ListBoxEx.SelectItem("Plugin1", found_items[1], true);
end
end
ListBoxEx.SelectItem
ListBoxEx.SelectItem es para seleccionar un ítem del ListBoxEx.
ListBoxEx.SelectItem(ObjectName, Index, Event)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Event: Si seleccionas true el evento de “On Select” sera activado, si es false no.
Ejemplo:
result = Dialog.Input("", "Que Objeto desea selecionar:", "");
if result ~= "" then
ListBoxEx.SelectItem("Plugin1", result, true)
end
ListBoxEx.SelectNone
ListBoxEx.SelectNone es para eliminar cualquier selección que se allá echo.
ListBoxEx.SelectNone(ObjectName)
ObjectName: El nombre del Objeto.
Ejemplo:
ListBoxEx.SelectNone("Plugin1");
ListBoxEx.GetItemText
ListBoxEx.GetItemText devuelve el texto de un item del ListBoxEx.
ListBoxEx.GetItemText(ObjectName, Index, Event)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
RemoveTags: Si seleccionas true se borran los comandos HTML del texto, si es false no.
Returns: Devuelve el texto del ítem, si el resultado es "" ocurre error.
Ejemplo:
result = ListBoxEx.GetItemText("Plugin1", 1, true)
if result ~= "" then
Dialog.Message("Notice", result, MB_OK);
end
ListBoxEx.EnsureVisible
ListBoxEx.EnsureVisible es para asegurar que el artículo especificado es visible.
ListBoxEx.EnsureVisible(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Ejemplo:
ListBoxEx.EnsureVisible("Plugin1", 1)
ListBoxEx.DeleteItem
ListBoxEx.DeleteItem es para eliminar items del ListBoxEx.
ListBoxEx.DeleteItem(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Returns: Si el resultado es true el ítem se elimino, y si es false entonces no se elimino.
Ejemplo:
result = ListBoxEx.DeleteItem("Plugin1", 2);
if (result) then
Dialog.Message("Notice", "El elemento se elimino.", MB_OK);
end
ListBoxEx.GetItemCheck
ListBoxEx.GetItemCheck determina si el ítem esta chequeado o no.
ListBoxEx.GetItemCheck(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Returns: Si el resultado es true el ítem esta chequeado, y si es false entonces no lo esta.
Ejemplo:
result = ListBoxEx.GetItemCheck("Plugin1", 1);
if (result) then
Dialog.Message("Notice", "El elemento esta chequeado.", MB_OK);
end
ListBoxEx.GetItemData
ListBoxEx.GetItemData es para devolver el texto de un ítem data del ListBoxEx.
ListBoxEx.GetItemData(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Returns: Devuelve el texto del ítem data, si el resultado es "" ocurre error.
Ejemplo:
result = ListBoxEx.GetItemData("Plugin1", 2);
if result ~= "" then
Dialog.Message("Notice", "El item data es: "..result, MB_OK);
end
ListBoxEx.SetItemCheck
ListBoxEx.SetItemCheck es para gestionar los checkbox de los items.
ListBoxEx.SetItemCheck(ObjectName, Index, Cheked, Event)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Cheked: true es para seleccionar el checkbox, y si es false para des-seleccionarlo.
Event: Si seleccionas true el evento sera activado, si es false no.
Ejemplo:
ListBoxEx.SetItemCheck("Plugin1", 1, true, true);
ListBoxEx.SetItemText
ListBoxEx.SetItemText es para fijar un nuevo texto a un ítem ya creado.
ListBoxEx.SetItemText(ObjectName, Index, Text)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Text: El texto del ítem.
Ejemplo:
TexTo = "<p><b>Este es el nuevo texto<br>Que se mostrara.</b></p>"
ListBoxEx.SetItemText("Plugin1", 1, TexTo);
ListBoxEx.GetSelectedItem
ListBoxEx.GetSelectedItem consigue el índice del artículo seleccionado en un objeto de ListBoxEx.
ListBoxEx.GetSelectedItem(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Devuelve el indice del ítem seleccionado, si el resultado es 0 ocurre error.
Ejemplo:
result = ListBoxEx.GetSelectedItem("Plugin1");
if (result == 0) then
Dialog.Message("Notice", "Por favor selecione un item del ListBox");
end
ListBoxEx.SetItemData
ListBoxEx.SetItemData para agregar un nuevo data a un ítem de la lista del ListBoxEx.
ListBoxEx.SetItemData(ObjectName, Index, Data)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Data: Nuevo Data para un ítem especifico.
Ejemplo:
ListBoxEx.SetItemData("Plugin1", 1, "Nuevo Data")
ListBoxEx.GetCheckedItems
ListBoxEx.GetCheckedItems es para detectar los objetos chequeados.
ListBoxEx.GetCheckedItems(ObjectName)
ObjectName: El nombre del Objeto..
Returns: Devuelve el numero de items chequeados visibles, si el resultado es nil ocurre error.
Ejemplo:
result = ListBoxEx.GetCheckedItems("Plugin1");
if (result ~= nil) then
ListBoxEx.EnsureVisible("Plugin1", result[1]);
Dialog.Message("Notice", "Total "..Table.Count(result).." Item(s) Checked");
end
ListBoxEx.IsItemCheckBoxVisible
ListBoxEx.IsItemCheckBoxVisible es para detectar un item tiene el checkbox visible.
ListBoxEx.IsItemCheckBoxVisible(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Ejemplo:
result = ListBoxEx.IsItemCheckBoxVisible("Plugin1", 1);
ListBoxEx.AddIconEx
ListBoxEx.AddIconEx es para añadir iconos a la lista de imágenes usando fuentes externas.
ListBoxEx.AddIconEx(ObjectName, Resource, IconIndex)
ObjectName: El nombre del Objeto.
Resource: La ruta completa del archivo de icono.
IconIndex: El numero del indice que del icono que deseas usar.
Ejemplo:
bImagelist = ListBoxEx.CreateImageList("Plugin1", 64, BIT_32);
if ( bImagelist ) then
ListBoxEx.AddIconEx("Plugin1", _WindowsFolder.."\\System32\\Shell32.dll", 47);
ListBoxEx.AddIconEx("Plugin1", _WindowsFolder.."\\System32\\Shell32.dll", 48);
ListBoxEx.AddIconEx("Plugin1", _WindowsFolder.."\\System32\\Shell32.dll", 47);
end
ListBoxEx.GetItemIconSize
ListBoxEx.GetItemIconSize es para conseguir el tamaño de un icono de un ítem del ListBoxEx.
ListBoxEx.GetItemIconSize(ObjectName, Index)
ObjectName: El nombre del Objeto.
Index: El numero del indice que del icono que deseas usar.
Ejemplo:
result = ListBoxEx.GetItemIconSize("Plugin1", 1);
ListBoxEx.SetItemIconSize
ListBoxEx.SetItemIconSize es para fijar el tamaño de un icono de un ítem del ListBoxEx.
ListBoxEx.SetItemIconSize(ObjectName, Index, IconSize)
ObjectName: El nombre del Objeto.
Index: El numero del indice que del icono que deseas usar.
IconSize: El tamaño que se fijara al icono.
Ejemplo:
result = ListBoxEx.SetItemIconSize("Plugin1", 1, 32);
ListBoxEx.SetItemCheckBoxVisible
ListBoxEx.SetItemCheckBoxVisible es para ocultar o hacer visible un checkbox de un objeto en
particular de ListBoxEx.
ListBoxEx.SetItemCheckBoxVisible(ObjectName, Index, Visible)
ObjectName: El nombre del Objeto.
Index: El numero del indice que deseas usar.
Visible: Si seleccionas true le checkbox sera visibles, y si es false entonces no sera visible.
Ejemplo:
ListBoxEx.SetItemCheckBoxVisible("Plugin1", 1, false);
ListBoxEx.SetItemCheckBoxVisible("Plugin1", 3, false);
ListBoxEx.SetUpdate("Plugin1", true);
ListBoxEx.Sort
ListBoxEx.Sort especifica el orden de los articulos.
ListBoxEx.Sort(ObjectName, Order)
ObjectName: El nombre del Objeto.
Order: El tipo de orden.
CONSTANTE
VALOR
DESCRIPCIÓN
LBXSORT_ASC
1
Clase en orden ascendente.
LBXSORT_DESC
0
Clase en orden descendente.
Returns: Si el resultado es true funciona, y si es false entonces es que falla.
Ejemplo:
result = ListBoxEx.Sort("Plugin1", LBXSORT_ASC);
ListBoxEx.MoveItem
ListBoxEx.MoveItem mueve un articulo de un indice a otro epsecifico.
ListBoxEx.MoveItem(ObjectName, MoveFrom, MoveTo)
ObjectName: El nombre del Objeto.
MoveFrom: El indice del articulo de origen que desea mover a otro indice.
MoveTo: El índice basado en cero para mover artículo especificado. El 0 (cero) es para poner el
articulo el primero en la lista del ListBoxEx.
Returns: Si el resultado es true funciona, y si es false entonces es que falla.
Ejemplo:
result = ListBoxEx.MoveItem("Plugin1", 2, 5);
ListBoxEx.SwapItems
ListBoxEx.SwapItems cambia el contenido de un articulo por otro.
ListBoxEx.SwapItems(ObjectName, Index, SwapWith)
ObjectName: El nombre del Objeto.
Index: El indice del articulo que quieres cambiar por otro.
SwapWith: El indice del articulo que quieres cambiar por otro.
Returns: Si el resultado es true funciona, y si es false entonces es que falla.
Ejemplo:
result = ListBoxEx.SwapItems("Plugin1", 1, 4);
ListBoxEx.EnumModuleIcons
ListBoxEx.EnumModuleIcons enumera los recursos de iconos de un archivo ejecutable.
ListBoxEx.EnumModuleIcons(ObjectName, Resource)
ObjectName: El nombre del Objeto.
Resource: Ruta completa del archivo ejecutable (Formato: exe, dll, ocx, icl,cpl).
Returns: Devuelve una tabla numerica con los valores de los iconos. Si el resultado es nil es que no
contiene recursos de iconos.
Ejemplo:
result = ListBoxEx.EnumModuleIcons("Plugin1", "Shell32.dll");
ListBoxEx.IsTooltipsVisible
ListBoxEx.IsTooltipsVisible informa si los tooltips son visibles o no.
ListBoxEx.IsTooltipsVisible(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Si el resultado es true los Tooltips es visible, y si es false entonces no son visibles.
Ejemplo:
result = ListBoxEx.IsTooltipsVisible("Plugin1");
ListBoxEx.SetTooltipsVisible
ListBoxEx.SetTooltipsVisible sirve para fijar si los tooltips son visibles o no.
ListBoxEx.SetTooltipsVisible(ObjectName, Visible)
ObjectName: El nombre del Objeto.
Visible: Si seleccionas true los Tooltips son visibles y si es false no son visibles.
Ejemplo:
ListBoxEx.SetTooltipsVisible("Plugin1", true);
ListBoxEx.SetTooltipProperties
ListBoxEx.SetTooltipProperties es para modificar las propiedades de los tooltips.
ListBoxEx.SetTooltipsVisible(ObjectName, TextColor, BackGroundBegin,
BackGroundMiddle, BackGroundEnd)
ObjectName: El nombre del Objeto.
TextColor: El Color de los textos de los tooltips.
BackGroundBegin: El Color de fondo del inicio de los tooltips.
BackGroundMiddle: El Color de fondo del medio de los tooltips.
BackGroundEnd: El Color de fondo del final de los tooltips.
MaxWidth: La anchura máxima de ventana de los tooltips.
Ejemplo:
ListBoxEx.SetTooltipProperties("Plugin1", 255, 16777215, 10092543, 16711935, 225);
ListBoxEx.GetTooltipProperties
ListBoxEx.GetTooltipProperties es para modificar las propiedades de los tooltips.
ListBoxEx.GetTooltipsVisible(ObjectName)
ObjectName: El nombre del Objeto.
Returns: Devuelve una tabla. Si ocurre un error el valor del resultado sera nil.
CONSTANTE
DESCRIPCIÓN
TextColor
El Color de los textos de los tooltips.
BackGroundBegin
El Color de fondo del inicio de los tooltips
BackGroundMiddle El Color de fondo del medio de los tooltips.
BackGroundEnd
El Color de fondo del final de los tooltips.
MaxWidth
La anchura máxima de ventana de los tooltips.
Ejemplo:
result = ListBoxEx.GetTooltipProperties("Plugin1");
Texto = "Informacion sobre de los Tooltips\r\n"
Texto = Texto.."Color del texto:\t\t"..result.TextColor.."\r\n"
Texto = Texto.."Color del Fondo Inicio:\t"..result.BackGroundBegin.."\r\n"
Texto = Texto.."Color del Fondo Medio:\t"..result.BackGroundMiddle.."\r\n"
Texto = Texto.."Color del Fondo Final:\t"..result.BackGroundEnd.."\r\n"
Texto = Texto.."Anchura Maxima:\t\t"..result.MaxWidth
Dialog.Message("Notice", Texto, MB_OK);
ListBoxEx.SetItemTooltipText
ListBoxEx.SetItemTooltipText para fijar un nuevo texto en un tooltip especifico.
ListBoxEx.SetTooltipsVisible(ObjectName, Index, Text)
ObjectName: El nombre del Objeto.
Index: El indice del articulo que quieres usar.
Text: El texto que se mostrara en el Tooltip.
Ejemplo:
Texto = "<p><font color=#0000FF face=Impact size=6>Este es un texto en Impact</font></p>"
ListBoxEx.SetItemToolTipText("Plugin1", 1, Texto);
ListBoxEx.GetItemTooltipText
ListBoxEx.GetItemTooltipText sirve para recuperar el texto de el Tooltip.
ListBoxEx.SetTooltipsVisible(ObjectName, Index, RemoveTags)
ObjectName: El nombre del Objeto.
Index: El indice del articulo que quieres usar.
RemoveTags: Si seleccionas true los Tag no son visibles y si es false son visibles.
Returns: Devuelve el texto del Tooltip. Si ocurre un error el resultado sera string vacio "".
Ejemplo:
result = ListBoxEx.GetItemToolTipText("Plugin1", 1, true);
Dialog.Message("Notice", result, MB_OK);
ListBoxEx.InsertItem
ListBoxEx.InsertItem es para agregar un ítem al ListBoxEx.
ListBoxEx.InsertItem(ObjectName, Index, ItemText, TooltipText, ItemData, ExtraData,
IconID, Style, ItemHeight, ItemColor, HighLightColor)
ObjectName: El nombre del Objeto.
Index: El índice basado cero para insertar el nuevo artículo. El 0 (cero) señala para poner índice lo
que es antes del primer artículo en ListBoxEx.
ItemText: El texto del ítem. (Nota: Soporta el formato HTML) Lista de Comando HTML
TooltipText: El texto del tooltip. (Nota: Soporta el formato HTML) Lista de Comando HTML
ItemData: El dato del articulo.
ExtraData: El dato extra del articulo.
IconID: La id del icono que se mostrara en el ítem.
Style: El estilo de texto que se usara.
VALOR
LBXITEM_HTML
DESCRIPCIÓN
El texto escrito sera filtrado como texto Html
para poder reconocer los comando.
LBXITEM_NORMAL El texto escrito sera filtrado como texto normal.
ItemHeight: La altura del ítem que se agregara, 0 para que el tamaño se fije automáticamente.
ItemColor: El color del ítem en formato de tabla décima (acepta asta 10 colores). Si fijas nil se
usara el color predefinido en las propiedades.
HighLightColor: El color del ítem cuando se pulsa sobre el en formato de tabla décima (acepta
asta 10 colores). Si fijas nil se usara el color predefinido en las propiedades.
Returns: Si el resultado es true funciona, y si es false entonces es que falla.
Ejemplo:
for Count = 0, 15 do
ItemText = "<b>Hello World <font color=#FF0000>"..Count.."</font></b>"
TooltipText = "<p><font color=#0000FF face=Impact size=6>Tooltip Texto</font></p>"
ListBoxEx.InsertItem("Plugin1", Count, ItemText, TooltipText, "", "", 1, LBXITEM_HTML, 0,
nil, {16316664,16764057});
end
ListBoxEx.AddItem
ListBoxEx.AddItem es para añadir un nuevo artículo a un objeto de ListBoxEx.
ListBoxEx.AddItem(ObjectName, ItemText, TooltipText, ItemData, ExtraData, IconID, Style,
ItemHeight, ItemColor, HighLightColor)
ObjectName: El nombre del Objeto.
ItemText: El texto del ítem. (Nota: Soporta el formato HTML) Lista de Comando HTML
TooltipText: El texto del tooltip. (Nota: Soporta el formato HTML) Lista de Comando HTML
ItemData: El dato del articulo.
ExtraData: El dato extra del articulo.
IconID: La id del icono que se mostrara en el ítem.
Style: El estilo de texto que se usara.
VALOR
LBXITEM_HTML
DESCRIPCIÓN
El texto escrito sera filtrado como texto Html
para poder reconocer los comando.
LBXITEM_NORMAL El texto escrito sera filtrado como texto normal.
ItemHeight: La altura del ítem que se agregara, 0 para que el tamaño se fije automáticamente.
ItemColor: El color del ítem en formato de tabla décima (acepta asta 10 colores). Si fijas nil se
usara el color predefinido en las propiedades.
HighLightColor: El color del ítem cuando se pulsa sobre el en formato de tabla décima (acepta
asta 10 colores). Si fijas nil se usara el color predefinido en las propiedades.
Retuns: Devuelve el numero indexado del ítem agregado. Si ocurre un error el resultado sera -1.
Ejemplo:
ItemText = "<b><font color=#FF0000>Hello World</font></b>"
TooltipText = "<p><font color=#0000FF face=Impact size=6>Tooltip Texto</font></p>"
ListBoxEx.AddItem("Plugin1", ItemText, TooltipText, "", "", 1, LBXITEM_HTML, 0, nil,
{16316664,16764057});
Lista de Comando HTML
Lista Anterior a la Version 2.0.0.0
COMANDOS
DESCRIPCIÓN
<br>
Es para hacer el Intro.
<b>
Es para poner el texto en negrita.
<u>
Es para poder subrayar el texto.
<em>
Es para poder enfatizar el texto.
<i>
Es para poner el texto en italic.
<p>
Es para centrar la altura del texto.
<strong>
Es para poner el texto en fuerte.
<sub>
Es para texto en formato SubScript.
<sup>
Es para texto en formato SuperScript.
<font color=#XXXXXX> Es para cambiar el color por uno deseado.
Ejemplo de HTML:
Linea superior<br>linea inferior
<b>Este texto esta en negrita</b>
<u>Este texto esta subrayado</u>
<em>Este es texto esta enfatizado</em>
<i>Este texto esta en italic</i>
<p>Este texto esta en centrado</p>
<strong>Este texto esta en Fuerte</strong>
<sub>Esto es texto en SubScript</sub>
<sup>Esto es texto en SuperScript</sup>
<font color=#FF0000>Este texto esta en rojo</font>
Lista Actualizada en la version 2.0.0.0
COMANDOS
<font>..</font>
ATRIBUTOS
color , face , size
DESCRIPCIÓN
Fuente.
<font color="#0000FF"
face="comic sans ms" size="6">
<a>..</a>
href
Anchador.
<a href="www.google.com">
<a href="something">
<hr>
color or none
Regla horizontal.
<hr color="#0000FF">
<sup>.. </sup>
No tiene Atributos.
Super script.
<sub>.. </sub>
No tiene Atributos.
Sub script.
<smal>.. </small> No tiene Atributos.
Pequeño.
<big>.. </big>
No tiene Atributos.
Grande.
<s>.. </s>
No tiene Atributos.
Emprender el
camino.
<u>.. </u>
No tiene Atributos.
Subrayado.
<i>.. </i>
No tiene Atributos.
Italic.
<b>.. </b>
No tiene Atributos.
Negrita.
<br>
No tiene Atributos.
Salto de linea.
<h1>..<h1>
No tiene Atributos.
Titulo 1.
<h2>..<h2>
No tiene Atributos.
Titulo 2.
<h3>..<h3>
No tiene Atributos.
Titulo 3.
<h4>..<h4>
No tiene Atributos.
Titulo 4.
<h5>..<h5>
No tiene Atributos.
Titulo 5.
<h6>..<h6>
No tiene Atributos.
Titulo 6.
Ejemplos
Barra de Busqueda
En este ejemplo podrás gestionar las barra de búsqueda y hacer que lance un dialogo diciendo el
numero de items que contiene el texto que se busca.
Ejemplo de Barra de Busqueda:
-- Esto va en la sección de "On Click" de un Button o Label para poder ver la barra de búsqueda.
ListBoxEx.SearchBarSetButton("Plugin1", "Buscar", 65);
ListBoxEx.SearchBarShow("Plugin1", true);
-- Esto va en la sección de "On SearchBtn" del ListBoxEx.
result = ListBoxEx.SearchBarGetText("Plugin1");
if (result ~= "") then
Busqueda = ListBoxEx.Find("Plugin1", result);
if (Busqueda ~= nil) then
Count = Table.Count(Busqueda)
MSJ = "El Texto que busca:\r\n"..result.."\r\nesta: "..Count.." en items del ListBoxEx."
Dialog.Message("Información", MSJ, MB_OK);
else
Dialog.Message("Información", "El Texto que busca no esta en el ListBoxEx.", MB_OK);
end
end
Eventos: e_Index
En este ejemplo podrás gestionar los ítems seleccionados usando el “On Select”, de este modo
podrás cargar un dialogo que mostrara un mensaje diciendo el objeto que as seleccionado y su
contenido, este ejemplo es valido para On Select, On DoubleClick, On RightClick y On CheckBox.
Ejemplo de e_Index:
-- “On Select” o “On CheckBox” o “On DoubleClick” o “On RightClick”.
if e_Index == 1 then
a1 = ListBoxEx.GetItemText("Plugin1", 1, true)
Dialog.Message("Notice", "Mensaje numero 1\r\n\r\nContenido:\r\n"..a1, MB_OK);
elseif e_Index == 2 then
a2 = ListBoxEx.GetItemText("Plugin1", 2, true)
Dialog.Message("Notice", "Mensaje numero 2\r\n\r\nContenido:\r\n"..a2, MB_OK);
end
Eventos: e_Checked y e_Index
En este ejemplo podrás gestionar los checkbox cuando son activados y cuando son desactivados, es
un ejemplo simple pero con el que se muestra como lanzar mensajes cuando se activa o desactiva
un checkbox de la ListBoxEx.
Ejemplo de e_Checked y e_Index:
-- “On CheckBox”
if e_Index == 1 then
if e_Checked == true then
eStaDo = "CheckBox numero 1\r\n\r\nActivado\r\n\r\nEl estado de e_Checked es: true"
Dialog.Message("Notice", eStaDo, MB_OK);
elseif e_Checked == false then
eStaDo = "CheckBox numero 1\r\n\r\nDesactivado\r\n\r\nEl estado de e_Checked es: false"
Dialog.Message("Notice", eStaDo, MB_OK);
end
elseif e_Index == 2 then
if e_Checked == true then
eStaDo = "CheckBox numero 2\r\n\r\nActivado\r\n\r\nEl estado de e_Checked es: true"
Dialog.Message("Notice", eStaDo, MB_OK);
elseif e_Checked == false then
eStaDo = "CheckBox numero 2\r\n\r\nDesactivado\r\n\r\nEl estado de e_Checked es: false"
Dialog.Message("Notice", eStaDo, MB_OK);
end
end
Eventos: e_Index en “On RightClick”
En este ejemplo es para poder crear un menucontextual del estilo de windows como el que usa el
mismo autoplay para crear las barras de menus, este ejemplo esta extraido del mismo ejemplo del
ListBoxEx de la version 2.1.0.0.
Ejemplo de uso de e_Index para crear un tooltip stylo windows:
-- “On RightClick”
tblMenu = {};
tblMenu[1] ={};
tblMenu[1].Text = "delete item";
tblMenu[1].ID = 200;
tblMenu[1].IconID = 0;
tblMenu[1].Checked = false;
tblMenu[1].Enabled = true;
tMousePos = System.GetMousePosition(true, Application.GetWndHandle());
nRes = Application.ShowPopupMenu(tMousePos.X, tMousePos.Y, tblMenu,
TPM_LEFTALIGN, TPM_TOPALIGN, true, true);
if nRes == 200 then
ListBoxEx.DeleteItem("Plugin1", e_Index);
end
Math.HexColorToNumber
En este ejemplo podras usar Math.HexColorToNumber que es un comando que ya va incluido en
los predefinidos del AMS “Autoplay Media Studio” para usar colores Hexadecimal en vez de usar
los colores decimales que son los necesarios en la mayoría de comandos del ListBoxEx.
Ejemplo de Math.HexColorToNumber:
Yellow = Math.HexColorToNumber("FFFF00");
Fuchsia = Math.HexColorToNumber("FC0FC0");
OrangeRed = Math.HexColorToNumber("FF4500");
Red = Math.HexColorToNumber("FF0000");
ListBoxEx.InsertItem("Plugin1", "Ejemplo", "", 0, HTML, 0, {Yellow, Fuchsia, OrangeRed,
LightSeaGreen, Red }, nil);
Lista de Imagenes usando -ListBoxEx.AddIcon- o -ListBoxEx.AddIconExEste ejemplo es para poder crear una lista de imágenes “Iconos”, que sera usada por otros comandos
del proyecto de forma indexada, de este modo los iconos serán numerados en el indice desde el 1 al
3.. en este caso, solo ay 3 imágenes así que la lista es sera del 1 al 3. Por ultimo decirte que con es
posible usar también esto con el comando ListBoxEx.AddIconEx.
Ejemplo de Lista de Imagenes:
-- Esto va en la sección de "On Create"
ListaDeImagenes = ListBoxEx.CreateImageList("Plugin1", 40, BIT_32);
if (ListaDeImagenes) then
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icono_A.ico"); -- este es el 1
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icono_B.ico"); -- este es el 2
ListBoxEx.AddIcon("Plugin1", "AutoPlay\\Icons\\Icono_C.ico"); -- este es el 3
end
Barra de Mensaje
Este ejemplo es para poder crear una barra de mensaje y crear una accion cuando pulsas sobre la
barra, este ejemplo es simple pero te puede valer para checkear si un programa esta instalado y si no
lo esta hacer que lance un mensaje informado de ello.
Ejemplo de Barra de Mensaje:
-- Esto se puede poner en un button, label o en "On Show" o donde quieras prácticamente.
if not (ProductoX) then
texto = "Para continuar es necesario tener instalado X.\r\nClick aquí para instalar el producto X.";
MB_Activa = ListBoxEx.MessageBarShow("Plugin1", texto, 0, false, true);
end
-- Esto va en la sección de "On MB-LeftClick" o en "On MB-RightClick"
if (Instalado) then
ListBoxEx.MessageBarHide("Plugin1");
end
if (MB_Activa) then
result = File.Run("Instalador_de_X.exe", "", "", SW_SHOWNORMAL, true);
texto = "El producto X a sido instalado correctamente."
Instalado = ListBoxEx.MessageBarShow("Plugin1", texto, 3, true, true);
MB_Activa = false
end
Crear un Tooltip personalizado para cada item
Este ejemplo es para poder crear Tooltips personalizados para cada item, solo tienes que cambiar el
index o hacerlo como yo con un contador, la verdad es que las modificaciones son minimas pero es
mas que nada para que veais como funcionan los tooltips de ListBoxEx con los cuales puedes
cargar tambien enlaces clickeables, es realmente interesante.
Ejemplo de Barra de Mensaje:
-- Yo este ejemplo lo he puesto en un boton, pero se puede poner en muchos eventos de autoplay
Tool_result = ListBoxEx.IsTooltipsVisible("Plugin1");
if Tool_result == false then
ListBoxEx.SetTooltipsVisible("Plugin1", true);
end
-- Este ejemplo es solo para 5 objetos de la lista
for count = 0, 5 do
Font = "<font color=#0000FF face=comic sans ms size=4>"
C_Font = "</font>"
Texto = "<h1>Titulo Aqui<h1><br>"..Font.."Ejemplo Texto en
Comic"..C_Font.."<br><h2>Texto del objeto Num. "..count.."<h2>"
ListBoxEx.SetItemToolTipText("Plugin1", count, Texto);
end
ListBoxEx.SetTooltipProperties("Plugin1", 0, 52479, 65535, 10092543, 225);
Espero que estos tutoriales os sean de gran utilidad, la verdad es que me gustaria poneros mas
ejemplos pero no dispongo de todo el tiempo que me gustaria, y bueno la verdad es que he esperado
asta la version 2.1.0.0 para actualizar este manual por que no esta disponible la version crackeada y
claro no todos somos usuarios de una version origial, “jejeje...”. Bueno espero que os funcione todo
bien si teneis alguna dudaos recomiendo os paseis por los sitios que os mustro debajo. Y recordar
que ListBoxEx se puede implementar con otros plugins y sus posibilidades son muchisimas.
Este tutorial a sido creador por Ceone para AMSSpecialist y Darkreloaded entre otras paginas... si
os a gustado y queréis mas tutoriales os recomiendo que visitéis las paginas nombras anteriormente.