Jump to content

Kexi/Handbook/Kexi Basics/The Kexi Main Window: Difference between revisions

From KDE Wiki Sandbox
Yurchor (talk | contribs)
m add false brackets to alleviate translation
Jstaniek (talk | contribs)
 
(45 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
<translate>
<translate>
===The Kexi Main Window=== <!--T:1-->
===The KEXI Main Window=== <!--T:1-->


<!--T:2-->
<!--T:2-->
[[Image:kexi_MainWindow.png|center]]
[[Image:kexi_MainWindow.png|800px|center]]


<!--T:3-->
<!--T:3-->
The main window of the '''KEXI''' application consists of rectangular elements. You can resize or hide some of them.
The '''Tabbed Toolbar''' on the top gives access to common actions and commands.
The '''Tabbed Toolbar''' on the top gives access to common actions and commands.


<!--T:4-->
<!--T:4-->
The '''Project Navigator''' and '''Properties Editor''' are shown in panes on each side of the child window. These can be resized or hidden as required. A pane can be hidden by clicking the small cross at the top of the pane (just below the toolbar).  
The '''Project Navigator''' and '''Property Editor''' are shown in panes on each side of the child window. These can be resized or hidden as required. A pane can be hidden by clicking the small cross at the top of the pane (just below the toolbar).  


<!--T:5-->
<!--T:5-->
Database objects (tables, queries, etc.) listed in the '''Project Navigator''' can be opened by clicking (or double-clicking, depending upon your global KDE settings) on their names.
Database objects (tables, queries, reports.) listed in the '''Project Navigator''' can be opened by double-clicking on their names.
 
====Main Application Elements==== <!--T:6-->


====Main application elements==== <!--T:6-->
[[Image:Kexi_MainWindow_Elements.png|800px|center]]


<!--T:7-->
<!--T:7-->
Main elements of '''Kexi''' application's window are:  
The main elements of '''KEXI''' application's window are:


<!--T:8-->
<!--T:8-->
;Tabbed Toolbar
#'''Menu bar''' gives access to global commands for the application. For a detailed description, refer to [[Special:myLanguage/Kexi/Handbook/References/Menu Commands|Appendix C: Menu Commands]].
:Contains available commands for the application. You will find detailed description of any of the commands in the appendix.</translate>
#'''KEXI button''' gives access to project-related commands, grouped in a special '''KEXI Menu'''. For a detailed description, refer to [[Special:myLanguage/Kexi/Handbook/References/Menu Commands/The KEXI Menu|Appendix C: Menu Commands &rarr; KEXI Menu]].
<translate><!--T:40-->
#'''Global Search box''' allows you to quickly search for objects within your opened project.
;Project Navigator pane
#'''Tabbed Toolbar''' contains the most common global and contextual commands. For a detailed description, refer to  [[Special:myLanguage/Kexi/Handbook/References/Toolbar_Commands|Appendix C: Toolbar Commands]].
: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. </translate>
#'''Project Navigator pane'''. On the left side of the pane, consisted of a '''Mode Selector''' and a list of all objects available within the currently opened project.
#'''Tabs of opened project objects''' allow you to switch between the tabs of each object currently open within the project.
#'''A mini toolbar''' provides contextual commands that operate on a given open object within the project.
#'''Area with opened objects in the project''' is the central area of the application, utilizing most of the screen space, and contains design or data related to the object.
#'''Property Editor pane''' contains a list of properties for the currently edited object in the project, such as a form or table.
</translate>
 
<translate>
<translate>
<!--T:41-->
====Project Navigator Pane (5)==== <!--T:17-->
;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. </translate>
<translate>
<!--T:42-->
;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==== <!--T:9-->
 
<!--T:10-->
[[Image:kexi_TabbedToolbar.png|center]]
 
<!--T:11-->
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:
 
<!--T:12-->
* Create / Open / Close Kexi projects
 
<!--T:13-->
* Create Database objects
 
<!--T:14-->
* Import / Export Data
 
<!--T:15-->
* Create widgets on your Forms
 
<!--T:16-->
* Create widgets on your Reports
 
====Project Navigator pane==== <!--T:17-->
 
<!--T:18-->
[[Image:kexi_ProjectNavigator.png|center]]


<!--T:19-->
<!--T:19-->
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 is one of the most frequently used elements of the '''KEXI''' main window. It consists of two parts:
 
#Left Side - '''Mode Selector''' - used to perform specific tasks, such as data entry or designing tables and forms.
<!--T:20-->
#Right Side - '''List of All Objects''' - displays all objects available within the currently opened project.
The Project Navigator pane also contains a small toolbar for most frequently used commands (from left to right): <menuchoice>Open</menuchoice> selected object, <menuchoice>Design</menuchoice> selected object, and <menuchoice>Delete</menuchoice> selected object.
#* Objects are grouped into categories: tables, queries, forms, and reports.
 
#* To open an object in ''Data View'', simply click its name.
<!--T:21-->
#* If the object's window is already open, this action activates the window without changing its view mode.
For each object on the list a context menu is available using the right mouse button.
#* A context menu is available for each object in the list by right-clicking. Detailed information about these menus can be found in [[Special:MyLanguage/Kexi/Handbook/References/Menu Commands/Context Menus in the Project Navigator|Appendix C: Context Menus in the Project Navigator]].
 
<!--T:22-->
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.  


<!--T:23-->
<!--T:23-->
{{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.}}
{{Note|Depending on your operating system settings and configuration of '''KEXI''', opening an object can be alternatively performed by a double click.}}
 
====Opened database objects area / Tabbed Windows==== <!--T:24-->


<!--T:25-->
====Tabs of opened project objects (6)==== <!--T:24-->
[[Image:kexi_WindowTabs.png|center]]


<!--T:26-->
<!--T:26-->
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'''.  
Whenever you double-click an object in the '''Project Navigator''', it opens in the '''Opened Project Objects Area''', and a new tab is created for that object.


<!--T:27-->
<!--T:27-->
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.
You can rearrange these ''object tabs'' by dragging and dropping them, and close them using the [[File:Kexi_CloseTabIcon.png|link=]] button located on the right side of each tab.
 
<!--T:28-->
{{Note|Sometime later on there will be an option to detach tabs, creating somewhat something similar to an MDI interface. That could be useful for custom solutions or multiple displays.}}


====Property Editor pane==== <!--T:29-->
Object tabs also have their own context menus, accessible by right-clicking. For details, refer to [[Special:MyLanguage/Kexi/Handbook/References/Menu Commands/Context Menu in the Object Tab|Appendix C: Context Menu in the Object Tab]].


<!--T:30-->
====Property Editor Pane (9)==== <!--T:29-->
[[Image:kexi_PropertyEditor.png|center]]


<!--T:31-->
<!--T:31-->
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, <menuchoice>Properties</menuchoice>, contains the list of available properties.  
The '''Property Editor''' pane contains a list of properties for the currently edited object in the project, such as a form or table. Depending on the context, the pane consists of one or more tabs or section. The first, always present section contains the list of available properties.  


<!--T:32-->
<!--T:32-->
Line 115: Line 79:
<translate>
<translate>
<!--T:45-->
<!--T:45-->
** a number; you can enter the value directly or increase or decrease its value by clicking with the left mouse button on the arrows. </translate>
** a number; you can enter the value directly or increase or decrease its value by clicking with the left mouse button on the up/down arrows at the right of the value field. </translate>
<translate>
<translate>
<!--T:46-->
<!--T:46-->
Line 121: Line 85:
<translate>
<translate>
<!--T:47-->
<!--T:47-->
** drop down list of values</translate>
** a drop down list of values; click on the desired value to select</translate>
<translate>
<translate>
<!--T:48-->
<!--T:48-->
** 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.  


<!--T:34-->
<!--T:34-->
<!--}}-->{{Note|
<!--}}-->{{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 <keycap>Enter</keycap> key.  
* There is no need to confirm a changed value: changes are applied ''immediately'' after moving to a different row of the Property Editor's list or by pressing the <keycap>Enter</keycap> key.
 
* Changes made to the property values are saved to the designed object when you perform the <menuchoice>Save</menuchoice> command. You can also abandon the changes by choosing not to save the object.


<!--T:49-->
<!--T:49-->
* Names of the recently changed properties that not yet were stored in the database are marked with bold text.  
* The names of properties with recently changed values that have not yet been saved to the project are displayed in bold text.


<!--T:50-->
<!--T:50-->
* After changing the value of a property, a special <menuchoice>Undo changes</menuchoice> 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 a property value, a special <menuchoice>Undo changes</menuchoice> button appears on the right side of the property name. Clicking this button reverts the property value to its original state, as loaded from the database when the database object was opened.}}<!--{{-->


<!--T:35-->
<!--T:35-->
The '''Property Editor''' pane is empty if:
The '''Property Editor''' pane is not visible if:


<!--T:36-->
<!--T:36-->
* no single database object's window is opened, or
* no single database object's window is open, or


<!--T:37-->
<!--T:37-->
* 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 as is the case when open in '''Data View'''.
 
====Resizing or Hiding Sections of the Main Window====
 
You can resize or hide sections of the main window to better organize your workspace or save space.
* The width of the '''Project Navigator''' pane can be adjusted by dragging its right border. To hide the pane, press <kbd>Alt+0</kbd>. Pressing the shortcut again will reveal the pane. This command is also accessible from the menu under <menuchoice>Window</menuchoice> → <menuchoice>Show Project Navigator</menuchoice>.
* The width of the '''Property Editor''' pane can be adjusted by dragging its right border. To hide the pane, press <kbd>Alt+3</kbd>. Pressing the shortcut again will reveal the pane. This command is also accessible from the menu under <menuchoice>Window</menuchoice> → <menuchoice>Show Project Navigator</menuchoice>.
 
{{Note|If the '''Property Editor''' pane is not available in the current context, such as when table data is displayed, the command will have no effect.}}
 


<!--T:38-->
<!--T:38-->
Line 149: Line 124:
|prevpage=Special:MyLanguage/Kexi/Handbook/Kexi_Basics/Creating_a_New_Database_File
|prevpage=Special:MyLanguage/Kexi/Handbook/Kexi_Basics/Creating_a_New_Database_File
|prevtext=Creating a New Database File
|prevtext=Creating a New Database File
|nextpage=Special:MyLanguage/Kexi/Handbook/Kexi_Basics/The_Kexi_Main_Window/Main_application_elements
|nextpage=Special:MyLanguage/Kexi/Handbook/Kexi_Basics/Opening an existing Kexi database file
|nexttext=Main application elements
|nexttext=Opening an existing Kexi database file
|index=Special:MyLanguage/Kexi/Handbook|indextext=Back to menu
|index=Special:MyLanguage/Kexi/Handbook|indextext=Back to menu
}}
}}

Latest revision as of 22:47, 22 December 2024

The KEXI Main Window

The main window of the KEXI application consists of rectangular elements. You can resize or hide some of them.

The Tabbed Toolbar on the top gives access to common actions and commands.

The Project Navigator and Property Editor are shown in panes on each side of the child window. These can be resized or hidden as required. A pane can be hidden by clicking the small cross at the top of the pane (just below the toolbar).

Database objects (tables, queries, reports.) listed in the Project Navigator can be opened by double-clicking on their names.

Main Application Elements

The main elements of KEXI application's window are:

  1. Menu bar gives access to global commands for the application. For a detailed description, refer to Appendix C: Menu Commands.
  2. KEXI button gives access to project-related commands, grouped in a special KEXI Menu. For a detailed description, refer to Appendix C: Menu Commands → KEXI Menu.
  3. Global Search box allows you to quickly search for objects within your opened project.
  4. Tabbed Toolbar contains the most common global and contextual commands. For a detailed description, refer to Appendix C: Toolbar Commands.
  5. Project Navigator pane. On the left side of the pane, consisted of a Mode Selector and a list of all objects available within the currently opened project.
  6. Tabs of opened project objects allow you to switch between the tabs of each object currently open within the project.
  7. A mini toolbar provides contextual commands that operate on a given open object within the project.
  8. Area with opened objects in the project is the central area of the application, utilizing most of the screen space, and contains design or data related to the object.
  9. Property Editor pane contains a list of properties for the currently edited object in the project, such as a form or table.

Project Navigator Pane (5)

The Project Navigator pane is one of the most frequently used elements of the KEXI main window. It consists of two parts:

  1. Left Side - Mode Selector - used to perform specific tasks, such as data entry or designing tables and forms.
  2. Right Side - List of All Objects - displays all objects available within the currently opened project.
    • Objects are grouped into categories: tables, queries, forms, and reports.
    • To open an object in Data View, simply click its name.
    • If the object's window is already open, this action activates the window without changing its view mode.
    • A context menu is available for each object in the list by right-clicking. Detailed information about these menus can be found in Appendix C: Context Menus in the Project Navigator.

Note

Depending on your operating system settings and configuration of KEXI, opening an object can be alternatively performed by a double click.


Tabs of opened project objects (6)

Whenever you double-click an object in the Project Navigator, it opens in the Opened Project Objects Area, and a new tab is created for that object.

You can rearrange these object tabs by dragging and dropping them, and close them using the button located on the right side of each tab.

Object tabs also have their own context menus, accessible by right-clicking. For details, refer to Appendix C: Context Menu in the Object Tab.

Property Editor Pane (9)

The Property Editor pane contains a list of properties for the currently edited object in the project, such as a form or table. Depending on the context, the pane consists of one or more tabs or section. The first, always present section 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 up/down arrows at the right of the value field.
    • text
    • a drop down list of values; click on the desired value to select
    • 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 applied immediately after moving to a different row of the Property Editor's list or by pressing the Enter key.
  • Changes made to the property values are saved to the designed object when you perform the Save command. You can also abandon the changes by choosing not to save the object.
  • The names of properties with recently changed values that have not yet been saved to the project are displayed in bold text.
  • After changing a property value, a special Undo changes button appears on the right side of the property name. Clicking this button reverts the property value to its original state, as loaded from the database when the database object was opened.


The Property Editor pane is not visible if:

  • no single database object's window is open, or
  • the active database object's window does not offer properties as is the case when open in Data View.

Resizing or Hiding Sections of the Main Window

You can resize or hide sections of the main window to better organize your workspace or save space.

  • The width of the Project Navigator pane can be adjusted by dragging its right border. To hide the pane, press Alt+0. Pressing the shortcut again will reveal the pane. This command is also accessible from the menu under WindowShow Project Navigator.
  • The width of the Property Editor pane can be adjusted by dragging its right border. To hide the pane, press Alt+3. Pressing the shortcut again will reveal the pane. This command is also accessible from the menu under WindowShow Project Navigator.

Note

If the Property Editor pane is not available in the current context, such as when table data is displayed, the command will have no effect.