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

From KDE UserBase Wiki
No edit summary
No edit summary
 
(16 intermediate revisions by the same user not shown)
Line 4: Line 4:


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


<!--T:3-->
<!--T:3-->
Line 26: Line 26:
<!--T:8-->
<!--T:8-->
#'''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]].
#'''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]].
#'''KEXI tab''' gives access to project-related commands. For a detailed description, refer to [[Special:myLanguage/Kexi/Handbook/References/Toolbar_Commands/The KEXI Toolbar|Appendix C: Toolbar Commands &rarr; The KEXI Toolbar]].
#'''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]].
#'''Global Search box''' allows you to quickly search for objects within your opened project.
#'''Global Search box''' allows you to quickly search for objects within your opened project.
#'''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]].
#'''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]].
#'''Project Navigator pane'''. On the left side of the pane, there is a '''Mode Selector''' that can be used to perform a particular task, such as data entry or designing tables and forms. On the right side of the pane, there is a list of all objects available within the currently opened project.
#'''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.
#'''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.
#'''A mini toolbar''' provides contextual commands that operate on a given open object within the project.
Line 37: Line 37:


<translate>
<translate>
====Tabbed Toolbar==== <!--T:9-->
====Project Navigator Pane (5)==== <!--T:17-->
 
<!--T:10-->
[[Image:kexi_TabbedToolbar.png|center]]
<!-- TODO: update screenshot -->
 
<!--T:11-->
The toolbar is the place that gives you access to most '''KEXI''' commands and actions.
Using 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:51-->
Depending on the context, additional tabs may be visible:
 
<!--T:52-->
* '''Form Design''' tab is only visible if the Form Designer is actually in use.
 
<!--T:53-->
* '''Report Design''' tab is only visible if the Report Designer is actually in use.
 
====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 the 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-->
====Tabs of opened project objects (6)==== <!--T:24-->
 
<!--T:25-->
[[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 {{Icon|tab-close}} button located on the right of each tab.
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-->
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]].
{{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-->
====Property Editor Pane (9)==== <!--T:29-->
 
<!--T:30-->
[[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 consists 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 129: Line 88:
<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 Name. 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.}}<!--{{-->
* 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-->
Line 148: Line 109:


<!--T:37-->
<!--T:37-->
* the active database object's window does not offer properties as is the case when open 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 show the pane. This command is also available in the menu under <menuchoice>Window</menuchoice> &rarr; <menuchoice>Show Project Navigator</menuchoice>.
 


<!--T:38-->
<!--T:38-->

Latest revision as of 15:11, 22 December 2024

Other languages:

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 show the pane. This command is also available in the menu under WindowShow Project Navigator.