Esta página es para la versión anterior. La página correspondiente en inglés ha sido eliminada en la versión actual.

Crear barras de herramientas para aplicaciones programáticas

Utilice la función uitoolbar

Use la función para agregar una barra de herramientas personalizada a la interfaz de usuario.uitoolbar Utilice las funciones y para añadir herramientas Push y herramientas de alternancia a una barra de herramientas.uipushtooluitoggletool Una herramienta de empuje funciona como un pulsador. Una herramienta de alternancia funciona como un botón de alternancia. Puede Agregar herramientas de inserción y alternar herramientas a la barra de herramientas estándar o a una barra de herramientas personalizada.

Las sintaxis para el, y las funciones incluyen lo siguiente:uitoolbaruipushtooluitoggletool

tbh = uitoolbar(fh,'PropertyName',PropertyValue,...) pth = uipushtool(tnh,'PropertyName',PropertyValue,...) tth = uitoggletool(tbh,'PropertyName',PropertyValue,...)

Los argumentos de salida, y son los identificadores, respectivamente, de la barra de herramientas resultante, la herramienta de inserción y la herramienta de alternancia.tbhpthtth Consulte las páginas de referencia para otras sintaxis válidas.uitoolbaruipushtooluitoggletool

Los temas siguientes describen las propiedades utilizadas habitualmente de las barras de herramientas y de la barra, ofrecen un ejemplo sencillo y analizan el uso de la barra de herramientas estándar:MATLAB®

Propiedades de uso común

En la tabla siguiente se muestran las propiedades que se utilizan con más frecuencia para describir una barra de herramientas y sus herramientas.

Propiedad

Valores

Descripción

CData

array 3-D de valores entre 0,0 y 1,0

matriz n-by-m-by-3 de valores RGB que define una imagen truecolor que se muestra en un botón pulsador o en un botón de alternancia.

HandleVisibility

, .onoff El valor predeterminado es.on

Determina si el identificador de un objeto está visible en la lista de elementos secundarios de su elemento primario. Para las barras de herramientas y sus utilidades, establezca para protegerlos de las operaciones no destinadas a ellos.HandleVisibilityoff

Separator

, .offon El valor predeterminado es.off

Dibuja una línea divisoria a la izquierda de la herramienta de empuje o de alternancia

State

, .offon El valor predeterminado es.off

Alternar estado de la herramienta. es la posición abajo o deprimida. es la posición arriba o elevada.onoff

Tooltip

Vector de caracteres o escalar de cadena

Texto de la información sobre herramientas asociada con la herramienta de inserción o la herramienta de alternancia.

Para obtener una lista completa de propiedades y más información sobre las propiedades enumeradas en la tabla, vea el, y.Toolbar PropertiesPushTool PropertiesToggleTool Properties

Barras

Las instrucciones siguientes agregan una barra de herramientas a una figura y, a continuación, agregan una herramienta de inserción y una herramienta de alternancia a la barra de herramientas. De forma predeterminada, las herramientas se agregan a la barra de herramientas, de izquierda a derecha, en el orden en que se crean.

% Create the toolbar fh = figure; tbh = uitoolbar(fh);  % Add a push tool to the toolbar a = [.20:.05:0.95]; img1(:,:,1) = repmat(a,16,1)'; img1(:,:,2) = repmat(a,16,1); img1(:,:,3) = repmat(flip(a),16,1); pth = uipushtool(tbh,'CData',img1,...            'Tooltip','My push tool',...            'HandleVisibility','off'); % Add a toggle tool to the toolbar img2 = rand(16,16,3); tth = uitoggletool(tbh,'CData',img2,'Separator','on',...            'Tooltip','Your toggle tool',...            'HandleVisibility','off');

es el identificador de la figura principal.fh

es el identificador de la barra de herramientas principal.th

es una matriz de valores de 16 por 16 por 3 entre 0 y 1.CData Define la imagen truecolor que se muestra en la herramienta. Si la imagen tiene más de 16 píxeles en cada dimensión, se puede recortar o provocar otros efectos indeseables. Si se recorta la matriz, solo se utiliza la parte central de 16 por 16 de la matriz.

Nota

Consulte la página de referencia para obtener información sobre la conversión de una matriz y el mapa de colores correspondiente, es decir, una imagen, al formato RGB (truecolor).ind2rgbX(X, MAP)

Especifica la información sobre herramientas de la herramienta de inserción y la herramienta de alternancia como y, respectivamente.TooltipMy push toolYour toggle tool

En este ejemplo, al establecer la propiedad de la herramienta de alternancia se crea una línea divisoria a la izquierda de la herramienta de alternancia.Separatoron

Puede cambiar el orden de las herramientas modificando el vector secundario de la barra de herramientas principal. Para este ejemplo, ejecute el código siguiente para revertir el orden de las herramientas.

oldOrder = allchild(tbh); newOrder = flipud(oldOrder); tbh.Children = newOrder;

Este código se usa porque la propiedad es un vector de columna.flipudChildren

Utilice la función para eliminar una herramienta de la barra de herramientas.delete La siguiente instrucción quita el herramienta de alternancia de la barra de herramientas. El manejador de la herramienta de alternancia es.tth

delete(tth)

Si es necesario, puede utilizar la función para determinar los identificadores de las herramientas en una barra de herramientas determinada.findall

Nota

Después de crear una barra de herramientas y sus herramientas, establezca sus propiedades ejecutando sentencias similares a las siguientes:HandleVisibilityoff

toolbarhandle.HandleVisibility = 'off'; toolhandles = toolbarhandle.Children; toolhandles.HandleVisibility = 'off';

Visualice y modifique la barra de herramientas estándar

Puede elegir si desea o no mostrar la barra de herramientas estándar (resaltada en rojo a continuación).MATLAB También puede Agregar o eliminar herramientas de la barra de herramientas estándar.

Visualice la barra de herramientas estándar

Utilice la propiedad figure para mostrar u ocultar la barra de herramientas estándar.ToolBar Se establece en para mostrar la barra de herramientas estándar.ToolBar'figure' Se establece en para ocultarlo.ToolBar'none'

fh.ToolBar = 'figure';  % Display the standard toolbar fh.ToolBar = 'none';    % Hide the standard toolbar

En estas instrucciones, es el identificador de la figura.fh

El valor predeterminado es, que utiliza el valor de propiedad.ToolBar'auto'MenuBar

Modifique la barra de herramientas estándar

Una vez que tenga el identificador de la barra de herramientas estándar, puede Agregar herramientas, eliminar herramientas y cambiar el orden de las herramientas.

Agregue una herramienta de la misma manera que la agredería a una barra de herramientas personalizada. Este código obtiene el identificador de la barra de herramientas estándar y le agrega una herramienta de alternancia.

tbh = findall(fh,'Type','uitoolbar'); tth = uitoggletool(tbh,'CData',rand(20,20,3),...             'Separator','on',...             'HandleVisibility','off');

Para quitar una herramienta de la barra de herramientas estándar, determine el identificador de la herramienta que se va a quitar y, a continuación, utilice la función para eliminarla.delete El código siguiente elimina la herramienta de alternancia que se agregó a la barra de herramientas estándar anterior.

delete(tth)

Si es necesario, puede utilizar la función para determinar los manejadores de las herramientas en la barra de herramientas estándar.findall

Consulte también

| |

Temas relacionados