BBinterface Tutorial by Jimmy

José Giovanni

Description

BBinterface tutorial by Jimmy Hi guys (and girls), the target of this guide is to give a basis knowledge about how to use bbinterface. Probably this is the most amazing and useful blackbox ‘s plugin because it gives us the ability to do almost everything, with the only limit of our imagination. 1. FRAME The frame is generally used as a container for other plugins, or other bbinterface’s controls (But we can also set a function for right click on it). If we want to attach a plugin to a frame we have simply to load the plugin. For doing it, Ctrl + right click on the frame, and follow this path Sometimes it could happen that the plugin is not immediately loaded in the frame. In this cases, we have to set, among the plugin properties, “in slit”. If, instead, we want to attach another bbinterface’s control to a frame, we have two different ways: 1) We can create the new control as “child control”. To do this is very simple, it is sufficient to choose from the frame’s menu (ctrl + right click) “create new child control”, and to choose the kind of control we want to attach. 2) If the control we want to attach already exists, we can directly attach it to the frame from its menu 2. BUTTON Buttons are generally used for launching applications, interacting with other plugins or programs (es. Winamp), or for interacting with the system (es. For shutdowning the system), and they are similar (in theire behaviour) to the buttons on the ...

Informations

• Publié par: Nifor
• Nombre de lectures: 68
• Langue: English

Extrait

BBinterface tutorial by Jimmy Hi guys (and girls), the target of this guide is to give a basis knowledge about how to use bbinterface. Probably this is the most amazing and useful blackbox ‘s plugin because it gives us the ability to do almost everything, with the only limit of our imagination. 1. FRAME The frame is generally used as a container for other plugins, or other bbinterface’s controls (But we can also set a function for right click on it). If we wantto attach a pluginto a frame we have simply to load the plugin. For doing it,Ctrl + right click on the frame, and follow this path Sometimes it could happen that the plugin is not immediately loaded in the frame. In this cases, we have to set, among the plugin properties, “in slit”. If, instead,we want to attach another bbinterface’s control to a frame, we have two different ways: 1)We can create the new control as “child control”. To do this is very simple, it is sufficient to choose from the frame’s menu (ctrl + right click) “create new child control”, and to choose the kind of control we want to attach.

2)control we want to attach already exists, we can directly attach it to the frame from itsIf the menu

2. BUTTON Buttons are generally used for launching applications, interacting with other plugins or programs (es. Winamp), or for interacting with the system (es. For shutdowning the system), and they are similar (in theire behaviour) to the buttons on the toolbar or on the windows. Let’s see what we can do with a button

First of all we need to know the difference among MouseDown, MouseUp, and RightMouseUp. MouseUp and MouseDown are two moments of the same left click… Think about what happens in a “click”: the mouse button is pressed and then released, so we can assign two different effects to these actions,so we have: MouseDown: left button pressed MouseUp: left button released RightMouseUp: Right button released. Now that we know this, let’s see what kind of effects we can assign to everyone of these actions. a. Run/Open: It works exactly as the “run” of windows. We can open folders or execute programs setting the right path, or we can use commands as “regedit” or “cmd”, etc… That’s not so difficult. b. BlackBox Bro@m Bro@m stays for “broadcast message”; trough it, it’s possible to communicate with other plugins, (for example for modifying their position or their size, or for hiding/showing them), or with blackbox (for example for restarting it, or for setting a style, etc.) Here you can find the Bro@ms recognized from the core of blackboxhttp://bb4win.sourceforge.net/bblean/docs/bblean_inc2.htm. At the moment it’s not so easy to understand, but a couple of examples are going to help us. Example n°1: To communicatewith other plugins Suppose you want to create a button for showing the previous/next month in bbcalendar. The only think we need is to know the correct bro@m. From the bbcalendar menu, we can see this Well. Now stick the menu “month” on the desktop (left click on the menu title), and choose “show bro@ms” from the following menu (right click on the desktop)

Now you can see that the content of the menu “month” is changed in this way

@BBCalendarNextMonthand@BBCalendarPreviousMonthare the bro@ms we need. Example n°2: To communicate with another BBInterface control Suppose you want to create a button which is capable to hide/show a frame (i.e. the name of this frame is Frame1). You need to know the correct bro@ms for these actions, so open the file binterface.rc, and go to the part which deals with Frame1; it will be, more or less this !---- Frame1 ---- @BBInterface Control Create Frame Frame1 @BBInterface Control SetWindowProperty Frame1 X 844 @BBInterface Control SetWindowProperty Frame1 Y 700 @BBInterface Control SetWindowProperty Frame1 Width 148 @BBInterface Control SetWindowProperty Frame1 Height 67 @BBInterface Control SetWindowProperty Frame1 Border false @BBInterface Control SetWindowProperty Frame1 Style "Toolbar" @BBInterface Control SetWindowProperty Frame1 IsVisible true @BBInterface Control SetWindowProperty Frame1 IsToggledWithPlugins true @BBInterface Control SetWindowProperty Frame1 IsOnAllWorkspaces true @BBInterface Control SetWindowProperty Frame1 IsOnTop false @BBInterface Control SetWindowProperty Frame1 AutoHide false @BBInterface Control SetWindowProperty Frame1 IsSlitted false @BBInterface Control SetWindowProperty Frame1 IsTransparent false @BBInterface Control SetWindowProperty Frame1 Transparency 100 @BBInterface Control SetControlProperty Frame1 HAlign "Center" @BBInterface Control SetControlProperty Frame1 VAlign "Top" @BBInterface Control SetControlProperty Frame1 HasTitleBar false @BBInterface Control SetControlProperty Frame1 IsLocked true As you can see in the bold line, Frame1 is set as “visible” (...... IsVisibletrue). If we want to make it invisible, we have to change the value “true” in “false”. I.e. you want that a left click shows the menu, and a right one hide the same; In MouseUp (or MouseDown) set @BBInterface Control SetWindowProperty Frame1 IsVisible true In RightMouseUp set @BBInterface Control SetWindowProperty Frame1 IsVisiblefalse Example n°3: @script What, perhaps, you still don’t know, is that @scripts give us the possibility to execute multiple commands just with one click. I.e. suppose you want to create a button which can, at the same time, resize and move a frame (obviously it works also with other kinds of control, or plugins). The correct syntax will be @script [@BBInterface Control SetWindowProperty Frame1Width 100|@BBInterface Control SetWindowProperty Frame1Height 40|@BBInterface Control SetWindowProperty Frame1X 700 |@BBInterface Control SetWindowProperty Frame1Y 600] In practice, @scripts allow us to execute more than one bro@m at the same time, so we can see how, pressing the button, Frame1 will be resized (width from 167 to 100, and height from 67 to 40), and will change its coordinates (X from 844 to 700 and Y from 700 to 600) The same operations can be executed using a very useful plugin called BroamRelay.

c. System/Shell As I said, it is possible to interact with the system and the shell. To do this is very easy, infact you have just to select the operation you want to execute when you click on the button in the following menu. d. Winamp Finally there is the possibility to interact with the famous player Winamp. This is very useful, expecially for who want to integrate in his desktop a winamp controller. 3. SWITCHBUTTON The switchbutton can be in to different status: Pressed and Unpressed. This means that it is possible to execute an actionwhen you press it (left click on it), and another one when you unpress it. Every kind of action described in the previous paragraph, can be executed by a switch button. In example, you could show a plugin pressing the switch button, and hide the same plugin unpressing it. Another useful application could consist in the creation of a switchbutton which launch an application (i.e ObjectDock) when it’s pressed, and close the same application launching a simple batch file like the following when unpressed @echo off tskill ObjectDock :end 4. SLIDER A slider is a kind of control which is tipically used for setting mixer’s volume level or the recording one.