Salva en 16:27 28 ago 2015

2015-08-28T16:27:41Z

Página nueva

{{Menu|cat=Extensiones|subcat=|Titulo=Basic IDE Tools 1.0.1: Tools and utilities for Basic IDE |1|2}}
{| class="mitb w80x100 sombra"
! Version
! Read
|-
| <big>
* 1.0.1 for Apache OpenOffice 3.4.1 and previous
</big>
| [[Basic IDE Tools para OpenOffice 101|Ayuda en línea Vers. 1.0.1 - Español]]
 
[[Basic IDE Tools for OpenOffice 101|Online Help Vers. 1.0.1 - English Translation]]
|-
| <big>
* 1.3.0 for Apache OpenOffice 4.0.0 and next
* 1.2.0 for Apache OpenOffice 3.4.1 and previous
</big>
| [[Basic IDE Tools para OpenOffice|Ayuda en línea Vers. 1.2, 1.3 - Español]]
 
[[Basic IDE Tools for OpenOffice|Online Help Vers. 1.2, 1.3 - English Translation]]
|}

== Content ==
<div class="menu-articulo">
*[[#What is Basic IDE Tools|What is '''Basic IDE Tools''']]
*[[#How to install Basic IDE Tools|How to Install]]
*[[#The Basic IDE Tools toolbar|The '''Basic IDE Tools''' toolbar]]
:*[[#Comment, uncomment or toggle comments|Comment, uncomment or toggle comments]]
:*[[#Indent, de-indent or re-indent all|Indent, de-indent or re-indent all]]
:*[[#Format code|Format code]]
:*[[#Find Previous and Find Next|Find Previous and Find Next]]
::*[[#Find and Replace|Find and Replace]]
:*[[#Convert to uppercase or lowercase|Convert to uppercase or lowercase]]
:*[[#Button About...|Button About...]]
*[[#Undo changes|Undo changes]]
*[[#Recommendations for the use of this extension|Recommendations for the use of this extension]]
*[[#Keywords recognized by the formatter|Keywords recognized by the formatter]]
</div>

== What is Basic IDE Tools ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:Extension.Basic.IDE.Tools.OpenOffice.Logo.jpg|left|link=http://aoo-extensions.sourceforge.net/en/project/basic-ide-tools]]
| '''Basic IDE Tools''' is an extension for '''Apache OpenOffice''' and '''OpenOffice.org''', developed by the '''open-office.es''' team, which adds a new toolbar to OpenOffice Basic editor ('''IDE''').

Includes several buttons that add new features and options that make working with macros and applications easier for the programmer when writing Basic code.

The extension is released under the GNU GPLv3 license. Before using the extension, please read the terms of the license.

The extension can be downloaded from the official website of Apache OpenOffice extensions: <big>{{enlace|http://aoo-extensions.sourceforge.net/en/project/basic-ide-tools|Basic IDE Tools Vers. 1.0.1}}</big>
|}

== How to install Basic IDE Tools ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:OOo3_Extension_128.png|right|link=]]
| style="padding-left:10px;" | Basic IDE Tools is installed like any other extension of '''OpenOffice'''. If after requesting the extension download does not start automatically the extension manager, locate the installation file on your hard drive ('''BasicIDETools.1.0.1.zip''' or '''BasicIDETools.1.0.1.oxt''') and double click itself, or from the context menu, select '''''Open With ... OpenOffice.org'''''.

After requesting permission to install, and accept the license terms, the extension will be integrated in OpenOffice.
[[Image:Extension.Basic.IDE.Tools.OpenOffice.000.png|center|link=]]
As for any extension, will have to close all open OpenOffice applications, including '''[[El_Inicio_Rapido_de_Apache_OpenOffice_4.x|Quick Start (in spanish)]]''' so; after restarting OpenOffice, it is activated correctly.
|}

== The Basic IDE Tools toolbar ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" |  
| style="padding-left:10px;" | The '''Basic IDE Tools''' toolbar presents eleven buttons that add new options to '''OpenOffice Basic editor''', and a '''About…''' button.
[[Image:Extension.Basic.IDE.Tools.OpenOffice.001.png|center|link=]]
{{Aviso|imagen=[[image:Señal_Nota.png|link=]]|color=RoyalBlue|texto=This extension uses the text from the clipboard of the operating system to read the selected text, and after processing, replace the selected text with the text processing. Therefore operations do not copy, cut or paste in any application while the extension is performing any process. The text content of the clipboard before using any of your options is stored to be restored after making the selection.}}

The functions of the buttons are as follows:
|}

== Comment, uncomment or toggle comments ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:Extension.Basic.IDE.Tools.OpenOffice.002.png|center|link=]]
| style="padding-left:10px;" | These three buttons, called '''Add comments''', '''Remove comments''' and '''Toggle Comments''' allow comments, uncomment or alternate comments on selected lines of code.

To apply these options:
::* Select the line or lines you want to add, remove or alternate comments, and...
::* Click on the appropriate button, or...
::* Use one of these keyboard shortcuts:
:::- '''Ctrl + Shift + C''' Add comments
:::- '''Ctrl + Shift + X''' Removes comments
:::- '''Ctrl + Shift + W''' Toggle comments

'''''Toggle comments''''' add comments to the lines that do not have, and remove comments on the lines that do have.

The following video shows the operation of these three options:

{{VideoYouTube|315|560|f67wdZ3ZUp4}}
|}

== Indent, de-indent or re-indent all ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:Extension.Basic.IDE.Tools.OpenOffice.003.png|center|link=]]
| style="padding-left:10px;" | These three buttons, called '''Indentation increase''', '''Indentation decrease''' and '''Re-indent All''', allow indent, de-indent or re-indent selected lines of the code.

To apply these options:
::* Select the line or lines you want to indent, de-indent or re-indent, or...
::* Select a function or subroutine, or...
::* Select all the code module, and...
::* Click on the appropriate button

'''Re-indent''' option applies automatically indentation to all code selected by examining the code.

The following video shows the operation of these buttons:

{{VideoYouTube|315|560|i5BrjZqhUbM}}

=== Rules that follow the option '''Re-indenting''' ===
To apply '''Re-indenting''' follow these rules:
:*All lines beginning with one of the keywords '''Private, Global, Public, Option, Sub, Function''' are placed at level zero (no indentation), as the lines that contain the keywords '''End Sub''' or '''End Function'''.
:*All lines beginning with the keywords '''<nowiki>'</nowiki>, Rem, Dim''' will be indented to the level used by the previous line.
:*The line following a line that begins with the keyword '''if''', which contain the keyword '''Then''' after that word, and that contain code, will be indented to the same level, considering that it is an '''if then else endif''' on one line sentence.
:*It is considered as separator decorative lines of code, and be indented to level zero, all beginning with the following text:
::::<nowiki>'_____</nowiki>
::::<nowiki>'-----</nowiki>
::::<nowiki>'*****</nowiki>
::::<nowiki>' ****</nowiki>
::::<nowiki>' ++++</nowiki>
::::<nowiki>rem --</nowiki>
:*Empty lines are not indented. The character used for indentation is the '''Tab''' ( '''Chr(9)''' )
:*If the line ends with the keyword ''':''' (label) is indented to level zero.
:*All spaces and tabs located at the end of lines processed will be removed.
|}

== Format code ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:Extension.Basic.IDE.Tools.OpenOffice.004.png|center|link=]]
| style="padding-left:10px;" | This button allows you to format the code of the selected lines, applying uniform criteria that improve the readability and visual appearance of the code. Used in conjunction with the option '''Re-indenting''', allows to get a code with a clear and structured look.

To apply this option:
::* Select the line or lines you want to format, or...
::* Select all function or subroutine you want to format, or...
::* Select all the code module to be formatted, and...
::* Click on the '''Format Basic code''' button, or...
::* Press the keyboard shortcut '''Ctrl + Shift + F'''.

=== Actions that the Basic code formatter can do ===
Running this option, can be applied the following actions on the selected code:
::* They read the names of the functions and subroutines in the format uppercase / lowercase as written on the declaration line of the function or subroutine.
::* They read the names of the variables in the format uppercase / lowercase as written in the declaration line of the function or subroutine by declaring them as arguments, or after sentences '''Dim''', '''Private''', '''Public''', '''Static''' or '''Global'''.
::* They read the names of the constants in the format uppercase / lowercase as written by declaring then sentence '''Const'''.
::* It replaces all Basic keywords for the same word formatted. For example, '''if''' is replaced by '''If''', '''select case''' by ''Select Case''', '''msgbox''' by '''MsgBox''', etc.
::* Replace all variables that are found in the code after the place in which they are declared, just like then assignation to the name of the function at the point of its declaration, by the same word formatted as was declared. For example, if the function is declared as '''Function HelloWord''', from that line, all calls to the function, such as '''Helloword''' or '''helloword''' are replaced by the '''HelloWord'''.
::* Comment lines (with '''<nowiki>'</nowiki>''' or '''rem''') are not modified.
::* Strings (all that is written in quotes '''"''') are not modified.
::* During the process shows a progress bar.

Formatting takes time, depending on the number of selected lines and the length itself. Do not perform any action while applying the code formatting, as clicking on the code, or select another module, or any other action in the IDE; not copy, cut and / or paste into other applications. Wait until then process finishes'''.

The following video shows the operation of this button:

{{VideoYouTube|315|560|8l5dZi9X9rg}}

=== Keywords recognized ===
See at the bottom of this page [[#Keywords recognized by the formatter|Keywords recognized by the formatter]].

=== Dose not format some variables, constants or function calls or subroutines ===
You may notice that the code does not have replaced the names of variables, constants, functions or subroutines with the format they have been declared. The reasons are:
:*In order to apply format to the variables and constants in the selected code lines, the lines where it declares must also be selected, otherwise they will not be detected. That is why it is advisable to select all lines between '''Sub''' and '''End Sub''' or between '''Function''' and '''End Function''', or better, select the entire module.
:*In order to format the variables and constants in selected lines of code that have been declared at the module level, must also be selected the lines where they are declared. Otherwise, they won't detected. Therefore it is advisable to select the entire module.
:*If a function or subroutine is called in the code before its declaration, it can't be identified by its statement format, and therefore, will not be replaced with the declared format. It is therefore necessary that the functions and subroutines are declared before use, although we know that this is not always possible.

In future versions we are hoping to solve these three problems.
|}

== Find Previous and Find Next ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:Extension.Basic.IDE.Tools.OpenOffice.005.png|center|link=]]
| style="padding-left:10px;" | These two buttons called '''Find Next''' and '''Find Previous''' let you search the selected text in the current module and in all then library modules.

To search the selected text:
::* Select the word or text you want to search, and...
::* Click on the appropriate button, or...
::* Press the keyboard shortcut:
::::* '''F3''' to find the next (forward or down)
::::* '''Shift + F3''' to find the previous (to back or up)
{{Aviso|imagen=[[image:Señal_Nota.png|link=]]|color=RoyalBlue|texto=On computers with MacOS system, the keyboard shortcuts '''F3''' and '''Shift + F3''' are used by the system, so it will not be active. You can customize the keyboard shortcuts to your liking. See [[Personalizar atajos de teclado|Customizing keyboard shortcuts (in Spanish)]] if you do not know how to do it}}
The following video shows the operation of these buttons:

{{VideoYouTube|315|560|slj2a53E7s4}}

=== Find and Replace ===
To execute the '''Find and Replace''' process, follow this procedure:
:# Select the text to paste, and copy it to the clipboard (eg with '''Ctrl + C''')
:# Select the first search string
:# Press the desired search button or the keyboard shortcut equivalent
:# Paste the clipboard contents (eg with '''Ctrl + V''')
:# To continue searching and replacing, repeat from step 3
|}

== Convert to uppercase or lowercase ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:Extension.Basic.IDE.Tools.OpenOffice.006.png|center|link=]]
| style="padding-left:10px;" | These two buttons called '''Uppercase''' and '''Lowercase''' allow to convert all uppercase or all lowercase, the selected code.

To apply these options:
::* Select the code you want to convert
::* Click on the appropriate button

The following video shows the operation of these buttons:

{{VideoYouTube|315|560|PPjECgjN9RE}}
|}

== Button About... ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:Extension.Basic.IDE.Tools.OpenOffice.007.png|center|link=]]
| style="padding-left:10px;" | Presents information about the '''Basic IDE Tools''' extension.

After pressing the button displays the following dialog:
[[Image:Extension.Basic.IDE.Tools.OpenOffice.009.png|center|link=]]
|}

== Undo changes ==
{| class="adaptable w100"
| valign="top" width="150" style="border-right:3px solid #afafaf;padding-right:10px;" | [[Image:Calc.33x.04.014.png|center|link=]]
| style="padding-left:10px;" | You can use the '''Undo''' button on the '''Standard''' toolbar of the IDE, or the keyboard shortcut '''Ctrl + Z''' to undo the changes made to the selected code.

We observed that the IDE undo button usually fail when trying to undo several steps. This error is not due to '''Basic IDE Tools'''. In our trials, the first step to undo has always been made without error, and we consider not secure to undo more steps.
|}

== Recommendations for the use of this extension ==
Creating a basic code can be the result of hours, days, months or even years of work. Therefore it is highly recommended that:
:* Back up your code before using this software.
:* Save the changes to your code always before using this software.

It has been done trials simulating errors. After saving the project, it has been added an option with a simulated error thath ruins the code. Then we closed the IDE editor without saving changes, after reloading the project, we recovered without problems the saved code before applying the option.

It is therefore recommended that you always save the changes before applying a command available in the extension. In the case of noticing that after applying a command for extension in its code has been wasted, you can follow the same procedure as described in the previous paragraph to attempt to retrieve the previously stored code.

Software that is the extension and any associated components are distributed in the hope that it will be useful, AS IS and WITHOUT ANY GUARANTEE of its performance, fitness for a particular purpose, or of the results obtained. If you use this extension, is at your own risk. We are not responsible for any damage or loss that may lead to the use of this software. By installing and / or using this software implies your acceptance of the terms of the GNU GPLv3 license that must enclose the software. Please refer to the GNU General Public License for more detailed information.

= Keywords recognized by the formatter =
The words recognized by the formatter are presented in the table below these lines. The formatter will replace any occurrence of these words in the code written by the same word with the same look as that presented in the table. They are presented in alphabetical order from left to right in each row, and up and down columns.

{| class="mitb sombra"
| Abs
| AND
| As
| Asc
| Atn

|-
| Base
| Beep
| Boolean
| ByRef
| Byte

|-
| ByVal
| Call
| Case
| cBool
| cByte

|-
| cCur
| cDate
| cDateFromISO
| cDateToISO
| cDbl

|-
| ChDir
| ChDrive
| Choose
| Chr
| cInt

|-
| cLng
| Close
| Compatible
| Const
| ConvertFromURL

|-
| ConvertToURL
| Cos
| CreateUNODialog
| CreateUNOListener
| CreateUNOService

|-
| CreateUNOStruct
| CreateUNOValue
| cSng
| cStr
| CurDir

|-
| Currency
| cVar
| Date
| DateSerial
| DateValue

|-
| Day
| DeclareSet
| DefBool
| DefCur
| DefDate

|-
| DefDbl
| DefInt
| DefLng
| DefObj
| DefSng

|-
| DefStr
| DefVar
| Dim
| Dir
| Do

|-
| Double
| Each
| Else
| ElseIf
| End

|-
| EndIf
| Environ
| Eof
| Eqv
| Erl

|-
| Err
| Error
| Exit
| Exp
| Explicit

|-
| False
| FileAttr
| FileCopy
| FileDateTime
| FileExists

|-
| FileLen
| Fix
| Float
| For
| Format

|-
| FreeFile
| FreeLibrary
| Function
| Get
| GetAttr

|-
| GetGUIType
| GetProcessServiceManager
| GetSolarVersion
| GetSystemTicks
| Global

|-
| GlobalScope
| GoSub
| GoTo
| Hex
| Hour

|-
| If
| IIf
| Imp
| In
| Input

|-
| InputBox
| InStr
| Int
| Integer
| Is

|-
| IsMissing
| IsNull
| It
| Join
| Kill

|-
| LBound
| LCase
| Left
| Len
| Line

|-
| Loc
| Local
| Lof
| Log
| Long

|-
| Loop
| LSet
| LTrim
| Mid
| Minute

|-
| MkDir
| Mod
| Month
| MsgBox
| Name

|-
| New
| Next
| Not
| Now
| Object

|-
| Oct
| On
| Open
| Option
| Optional

|-
| OR
| ParamArray
| Preserve
| Print
| Private

|-
| Public
| Put
| QbColor
| Randomize
| ReDim

|-
| Rem
| Reset
| Resume
| Return
| RGB

|-
| Right
| RmDir
| Rnd
| RSet
| RTrim

|-
| Second
| Seek
| Select
| SetAttr
| Sgn

|-
| Shell
| Sin
| Single
| Space
| Split

|-
| Sqr
| Static
| Step
| Stop
| Str

|-
| StrComp
| String
| Sub
| Switch
| Tan

|-
| Then
| ThisComponent
| Time
| Timer
| TimeSerial

|-
| TimeValue
| To
| Trim
| True
| TwipsPerPixelX

|-
| TwipsPerPixelY
| Type
| UBound
| UCase
| Until

|-
| Val
| Variant
| Wait
| Weekday
| Wend

|-
| While
| With
| XOR
| Year
| '''<nowiki>'</nowiki>'''
|}

''Translated by Diana Roldán García. Thanks''
{{Pie|cat=Extensiones|subcat=}}
[[Category:Ver.3.4.x]][[Category:Ver.3.3.x]][[Category:Ver.3.2.x]][[Category:Ver.3.1.x]]

Basic IDE Tools for OpenOffice 101 - Historial de revisiones

Salva en 16:27 28 ago 2015