(Initial)
 
(2.4 update)
Line 2: Line 2:
 
Main elements of Kexi application's window are:  
 
Main elements of Kexi application's window are:  
  
* Menubar
+
* Tabbed Toolbar
contains available commands for the application. You will find detailed description of any of the commands in the appendix.
+
Contains available commands for the application. You will find detailed description of any of the commands in the appendix.  
* Toolbar
+
* Project Navigator pane
contains most frequently used commands.  
 
* Project Navigator's pane
 
 
contains a list of any object (tables, queries, forms, ...) created within the currently opened database project. The navigator also contains small toolbar with most usable commands related to the database objects.  
 
contains a list of any object (tables, queries, forms, ...) created within the currently opened database project. The navigator also contains small toolbar with most usable commands related to the database objects.  
* Opened database objects area
+
* Opened Database Objects Area / Tabbed Windows
 
a central area of the application taking most of the screen space. For IDEAl user interface mode it contains switchable tabs with windows that are always maximized. For Childframe user interface mode it contains floating windows.  
 
a central area of the application taking most of the screen space. For IDEAl user interface mode it contains switchable tabs with windows that are always maximized. For Childframe user interface mode it contains floating windows.  
* Properties pane
+
* Property Editor pane
 
contains a list of properties of currently activated database object. For certain objects (e.g. form's widgets) it can have several tabs.  
 
contains a list of properties of currently activated database object. For certain objects (e.g. form's widgets) it can have several tabs.  
* Taskbar
+
 
contains a list of currently opened windows with database objects. For IDEAl user interface mode, it is available as a number of tabs.
+
===Tabbed Toolbar===
For Childframe user interface mode, it is available as a number of buttons, behaving just like your operating system's taskbar.
+
[[Image:kexi_TabbedToolbar.png||center]]
 +
The toolbar is the place that gives you access to most Kexi commands and actions.
 +
Using the the actions found in the different tabs on the toolbar you can:
 +
* Create / Open / Close Kexi projects
 +
* Create Database objects
 +
* Import / Export Data
 +
* Create widgets on your Forms
 +
* Create widgets on your Reports
  
 
===Project Navigator pane===
 
===Project Navigator pane===
The Project Navigator pane is one of the most frequently used elements of the Kexi main window. The pane contains a list of all objects created within the currently opened Kexi database project. The objects are split into groups: tables, queries, forms.  
+
[[Image:kexi_ProjectNavigator.png||center]]
 +
The Project Navigator pane is one of the most frequently used elements of the Kexi main window. The pane contains a list of all objects created within the currently opened Kexi database project. The objects are split into groups: tables, queries, forms, reports and scripts.
  
The Project Navigator pane also contains a small toolbar for most frequently used commands (from left to right): Open selected object, Design selected object, Create a new object, and Delete selected object.  
+
The Project Navigator pane also contains a small toolbar for most frequently used commands (from left to right): Open selected object, Design selected object, and Delete selected object.  
  
For each object on the list a context menu is available using the right mouse button. For example, this is context menu for the persons table.  
+
For each object on the list a context menu is available using the right mouse button.
  
Double clicking with the left mouse button on the object's name on the list allows to open the object in Data View. If the object's window was already opened, the action just activates the window without switching it's view mode.  
+
Double clicking with the left mouse button on the object's name on the list opens the object in Data View. If the object's window was already opened, the action just activates the window without switching it's view mode.  
  
Note that your operating system or window manager can be set up to handle single clicks instead of double clicks. In this case it is enough to single click on the object name to open its window.  
+
{{Note|Even though your operating system or window manager may be set up to handle single clicks instead of double clicks, Kexi uses double clicks in Project Navigator to avoid accidentally opening large datasets or executing queries.}}
  
===Database object windows===
+
===Opened database objects area / Tabbed Windows===
Opening an object's window
+
[[Image:kexi_WindowTabs.png||center]]
# Select the object in the Project Navigator pane.  
+
Whenever you double click an object in the project navigator, it opens in the Opened database objects area. Each window has its own tab in Kexi.  
# Click the Open button on the Project Navigator pane's toolbar.  
+
You can rearrange the tabs by drag and drop and close them using the close tab button located at the far right of the tab strip.
  
Commands related to object windows
+
{{Note|Sometime later on there will be an option to detach tabs, creating somewhat something similar to an MDI interface. That could be usefull for custom solutions or multiple displays.}}
* Closing an object window
 
When the IDEAl user interface mode (the default) is used, each window has its own tab. Place the mouse pointer on the icon on the tab. A Close button will become visible. Click it to close the tab.  
 
  
In the Childframe on the right hand of each opened window there are buttons you can use to control the window. Click the first one on the right hand to close the window.
+
===Property Editor pane===
 
+
[[Image:kexi_PropertyEditor.png||center]]
Alternatively, regardless of the user interface mode you are using, you can select Window->Close from the Menubar.
 
* Window buttons for Childframe user interface mode
 
The other buttons (from right to left) can be used to: maximize, minimize and undock the window.  
 
 
 
There's a small icon on the left side of the title bar which can be clicked to show a context menu with commands related to the window.
 
 
 
Property Editor pane
 
 
In the Property Editor pane you can change properties of the object displayed in the active window. Depending on the context, the pane is consisted of one or more tabs. The first, always visible tab, Properties, contains the list of available properties.  
 
In the Property Editor pane you can change properties of the object displayed in the active window. Depending on the context, the pane is consisted of one or more tabs. The first, always visible tab, Properties, contains the list of available properties.  
  
Line 55: Line 52:
 
** drop down list of values
 
** drop down list of values
 
** Yes/No; you can toggle the value by clicking on the button; Yes (true) means that the button is toggled on, >No (false) means that the button is toggled off.  
 
** Yes/No; you can toggle the value by clicking on the button; Yes (true) means that the button is toggled on, >No (false) means that the button is toggled off.  
 +
 +
{{Note|
 
* There is no need to confirm a changed value: changes are visible immediately after moving to a different row of the Property Editor's list or by pressing the Enter key.  
 
* There is no need to confirm a changed value: changes are visible immediately after moving to a different row of the Property Editor's list or by pressing the Enter key.  
 
* Names of the recently changed properties that not yet were stored in the database are marked with bold text.  
 
* Names of the recently changed properties that not yet were stored in the database are marked with bold text.  
* After changing the value of a property, a special Undo changes button appears on the right side of the Property Editor's list. By clicking it you can revert the value of the property to the original value that was loaded from the database upon opening the database object. The button is only visible when the property is actually highlighted.  
+
* After changing the value of a property, a special Undo changes button appears on the right side of the Property Editor's list. By clicking it you can revert the value of the property to the original value that was loaded from the database upon opening the database object. The button is only visible when the property is actually highlighted.}}
  
 
The Property Editor pane is empty if:
 
The Property Editor pane is empty if:
 
* no single database object's window is opened, or
 
* no single database object's window is opened, or
 
* the active database object's window does not offer properties; it is usually the case when it is opened in Data View instead of Design View
 
* the active database object's window does not offer properties; it is usually the case when it is opened in Data View instead of Design View

Revision as of 22:30, 19 September 2011

Main application elements

Main elements of Kexi application's window are:

  • Tabbed Toolbar

Contains available commands for the application. You will find detailed description of any of the commands in the appendix.

  • Project Navigator pane

contains a list of any object (tables, queries, forms, ...) created within the currently opened database project. The navigator also contains small toolbar with most usable commands related to the database objects.

  • Opened Database Objects Area / Tabbed Windows

a central area of the application taking most of the screen space. For IDEAl user interface mode it contains switchable tabs with windows that are always maximized. For Childframe user interface mode it contains floating windows.

  • Property Editor pane

contains a list of properties of currently activated database object. For certain objects (e.g. form's widgets) it can have several tabs.

Tabbed Toolbar

Kexi TabbedToolbar.png

The toolbar is the place that gives you access to most Kexi commands and actions. Using the the actions found in the different tabs on the toolbar you can:

  • Create / Open / Close Kexi projects
  • Create Database objects
  • Import / Export Data
  • Create widgets on your Forms
  • Create widgets on your Reports

Project Navigator pane

Kexi ProjectNavigator.png

The Project Navigator pane is one of the most frequently used elements of the Kexi main window. The pane contains a list of all objects created within the currently opened Kexi database project. The objects are split into groups: tables, queries, forms, reports and scripts.

The Project Navigator pane also contains a small toolbar for most frequently used commands (from left to right): Open selected object, Design selected object, and Delete selected object.

For each object on the list a context menu is available using the right mouse button.

Double clicking with the left mouse button on the object's name on the list opens the object in Data View. If the object's window was already opened, the action just activates the window without switching it's view mode.

Note-box-icon.png
Note
Even though your operating system or window manager may be set up to handle single clicks instead of double clicks, Kexi uses double clicks in Project Navigator to avoid accidentally opening large datasets or executing queries.


Opened database objects area / Tabbed Windows

Kexi WindowTabs.png

Whenever you double click an object in the project navigator, it opens in the Opened database objects area. Each window has its own tab in Kexi. You can rearrange the tabs by drag and drop and close them using the close tab button located at the far right of the tab strip.

Note-box-icon.png
Note
Sometime later on there will be an option to detach tabs, creating somewhat something similar to an MDI interface. That could be usefull for custom solutions or multiple displays.


Property Editor pane

Kexi PropertyEditor.png

In the Property Editor pane you can change properties of the object displayed in the active window. Depending on the context, the pane is consisted of one or more tabs. The first, always visible tab, Properties, contains the list of available properties.

Rules for using the Property Editor:

  • Each row contains a single property.
  • You can use the mouse or the keyboard to change values of particular properties.
  • Most frequently used types of property values are:
    • a number; you can enter the value directly or increase or decrease its value by clicking with the left mouse button on the arrows.
    • text
    • drop down list of values
    • Yes/No; you can toggle the value by clicking on the button; Yes (true) means that the button is toggled on, >No (false) means that the button is toggled off.
Note-box-icon.png
Note
* There is no need to confirm a changed value: changes are visible immediately after moving to a different row of the Property Editor's list or by pressing the Enter key.
  • Names of the recently changed properties that not yet were stored in the database are marked with bold text.
  • After changing the value of a property, a special Undo changes button appears on the right side of the Property Editor's list. By clicking it you can revert the value of the property to the original value that was loaded from the database upon opening the database object. The button is only visible when the property is actually highlighted.


The Property Editor pane is empty if:

  • no single database object's window is opened, or
  • the active database object's window does not offer properties; it is usually the case when it is opened in Data View instead of Design View

Content is available under Creative Commons License SA 4.0 unless otherwise noted.