Files
AdditionalLibs/B4A/Dialogs.xml

1086 lines
44 KiB
XML

<?xml version="1.0" encoding="UTF-8"?>
<root>
<doclet-version-NOT-library-version>1.06</doclet-version-NOT-library-version>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog</name>
<shortname>InputDialog</shortname>
<comment>This modal dialog allows the collection of user entered data in the form of text.
The default is free text but the input can be restricted to numeric characters only
or to signed numbers including a decimal point.</comment>
<owner>activity</owner>
<method>
<name>Show</name>
<comment>Shows a modal text input dialog with the specified message and title.
Message - The dialog message.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>message</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<property>
<name>Input</name>
<returntype>java.lang.String</returntype>
<parameter>
<name>value</name>
<type>java.lang.String</type>
</parameter>
<comment>Sets the initial text when the dialog is shown and returns the text entered by the user.</comment>
</property>
<property>
<name>PasswordMode</name>
<returntype>boolean</returntype>
<parameter>
<name>value</name>
<type>boolean</type>
</parameter>
<comment>Sets or returns whether this dialog hides the actual characters entered by the user.</comment>
</property>
<property>
<name>InputType</name>
<returntype>int</returntype>
<parameter>
<name>inputtype</name>
<type>int</type>
</parameter>
<comment>Sets or returns the input type accepted by the input box.Possible values are:
ThisDialogName.INPUT_TYPE_NUMBERS for integer numbers.
ThisDialogName.INPUT_TYPE_DECIMAL_NUMBER for signed decimal numbers.
ThisDialogName.INPUT_TYPE_TEXT for free text.
ThisDialogName.INPUT_TYPE_PHONE for telephone numbers.</comment>
</property>
<property>
<name>HintColor</name>
<returntype>int</returntype>
<parameter>
<name>hintcolor</name>
<type>int</type>
</parameter>
<comment>Gets or sets the hint text color.</comment>
</property>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Hint</name>
<returntype>java.lang.String</returntype>
<parameter>
<name>hint</name>
<type>java.lang.String</type>
</parameter>
<comment>Gets or sets the text that will appear when the dialog is empty.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
<field>
<name>INPUT_TYPE_NUMBERS</name>
<comment></comment>
<returntype>int</returntype>
</field>
<field>
<name>INPUT_TYPE_DECIMAL_NUMBERS</name>
<comment></comment>
<returntype>int</returntype>
</field>
<field>
<name>INPUT_TYPE_TEXT</name>
<comment></comment>
<returntype>int</returntype>
</field>
<field>
<name>INPUT_TYPE_PHONE</name>
<comment></comment>
<returntype>int</returntype>
</field>
<field>
<name>INPUT_TYPE_NONE</name>
<comment></comment>
<returntype>int</returntype>
</field>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.DateDialog</name>
<shortname>DateDialog</shortname>
<comment>This modal dialog allows the collection of user entered data in the form of a date.</comment>
<owner>activity</owner>
<method>
<name>Show</name>
<comment>Shows a modal date input dialog with the specified message and title.
Message - The dialog message.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>Message</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<method>
<name>SetDate</name>
<comment>Sets the date values of the dialog when is intially shown.</comment>
<returntype>void</returntype>
<parameter>
<name>dayofmonth</name>
<type>int</type>
</parameter>
<parameter>
<name>month</name>
<type>int</type>
</parameter>
<parameter>
<name>year</name>
<type>int</type>
</parameter>
</method>
<property>
<name>DayOfMonth</name>
<returntype>int</returntype>
<parameter>
<name>day</name>
<type>int</type>
</parameter>
<comment>Sets the day of month value of the dialog when is intially shown.
Returns the day of month value of the dialog when it is closed.</comment>
</property>
<property>
<name>Year</name>
<returntype>int</returntype>
<parameter>
<name>year</name>
<type>int</type>
</parameter>
<comment>Sets the year value of the dialog when is intially shown.
Returns the year value of the dialog when it is closed.</comment>
</property>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
<property>
<name>Month</name>
<returntype>int</returntype>
<parameter>
<name>month</name>
<type>int</type>
</parameter>
<comment>Sets the month value of the dialog when is intially shown.
Returns the month value of the dialog when it is closed.</comment>
</property>
<property>
<name>DateTicks</name>
<returntype>long</returntype>
<parameter>
<name>ticks</name>
<type>long</type>
</parameter>
<comment>Sets the date value of the dialog when is intially shown.
Returns the date value in ticks of the dialog when it is closed.</comment>
</property>
<field>
<name>ShowCalender</name>
<comment></comment>
<returntype>boolean</returntype>
</field>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.TimeDialog</name>
<shortname>TimeDialog</shortname>
<comment>This modal dialog allows the collection of user entered data in the form of a time.
The time may be entered in 12 or 24 hour format as determined by the programmer.</comment>
<owner>activity</owner>
<method>
<name>Show</name>
<comment>Shows a modal time input dialog with the specified message and title.
Message - The dialog message.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>Message</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<method>
<name>SetTime</name>
<comment>Sets the time values of the dialog when is intially shown.</comment>
<returntype>void</returntype>
<parameter>
<name>hour</name>
<type>int</type>
</parameter>
<parameter>
<name>minutes</name>
<type>int</type>
</parameter>
<parameter>
<name>hours24</name>
<type>boolean</type>
</parameter>
</method>
<property>
<name>Hour</name>
<returntype>int</returntype>
<parameter>
<name>hour</name>
<type>int</type>
</parameter>
<comment>Sets the hour value of the dialog when is intially shown.
Returns the hour value of the dialog when it is closed.</comment>
</property>
<property>
<name>Is24Hours</name>
<returntype>boolean</returntype>
<parameter>
<name>is24hours</name>
<type>boolean</type>
</parameter>
<comment>Sets or returns whether the dialog shows the time in 24 hour format.</comment>
</property>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Minute</name>
<returntype>int</returntype>
<parameter>
<name>minute</name>
<type>int</type>
</parameter>
<comment>Sets the minute value of the dialog when is intially shown.
Returns the minute value of the dialog when it is closed.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
<property>
<name>TimeTicks</name>
<returntype>long</returntype>
<parameter>
<name>ticks</name>
<type>long</type>
</parameter>
<comment>Sets the time value of the dialog when is intially shown.
Returns the time value in ticks of the dialog when it is closed.</comment>
</property>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.ColorDialog</name>
<shortname>ColorDialog</shortname>
<comment>This modal dialog allows the user to define a colour by its Red, Green and Blue components.</comment>
<owner>activity</owner>
<method>
<name>ARGB</name>
<comment>Returns an integer value representing the color built from the three components and with the specified alpha value.
Alpha - A value between 0 to 255 where 0 is fully transparent and 255 is fully opaque.</comment>
<returntype>int</returntype>
<parameter>
<name>alpha</name>
<type>int</type>
</parameter>
</method>
<method>
<name>Show</name>
<comment>Shows a modal color dialog with the specified title.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<property>
<name>Blue</name>
<returntype>int</returntype>
<parameter>
<name>blue</name>
<type>int</type>
</parameter>
<comment>Sets the value of the blue component of the dialog when is intially shown.
Returns the value of the blue component of the dialog when it was closed.</comment>
</property>
<property>
<name>Red</name>
<returntype>int</returntype>
<parameter>
<name>red</name>
<type>int</type>
</parameter>
<comment>Sets the value of the red component of the dialog when is intially shown.
Returns the value of the red component of the dialog when it was closed.</comment>
</property>
<property>
<name>Green</name>
<returntype>int</returntype>
<parameter>
<name>green</name>
<type>int</type>
</parameter>
<comment>Sets the value of the green component of the dialog when is intially shown.
Returns the value of the green component of the dialog when it was closed.</comment>
</property>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
<property>
<name>RGB</name>
<returntype>int</returntype>
<parameter>
<name>color</name>
<type>int</type>
</parameter>
<comment>Sets the value of the red, green and blue components of the dialog when is intially shown.
Returns the color of the red, green and blue components of the dialog when it was closed.
Alpha of the provided color is ignored on set and implicitly set to 255 (opaque) on get.</comment>
</property>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.ColorDialogHSV</name>
<shortname>ColorDialogHSV</shortname>
<comment>This modal dialog allows the user to define a colour by its Hue, Saturation and Value components.</comment>
<owner>activity</owner>
<method>
<name>ARGB</name>
<comment>Returns an integer value representing the color built from the three components and with the specified alpha value.
Alpha - A value between 0 to 255 where 0 is fully transparent and 255 is fully opaque.</comment>
<returntype>int</returntype>
<parameter>
<name>alpha</name>
<type>int</type>
</parameter>
</method>
<method>
<name>Show</name>
<comment>Shows a modal color dialog with the specified title.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<property>
<name>Value</name>
<returntype>float</returntype>
<parameter>
<name>value</name>
<type>float</type>
</parameter>
<comment>Sets the value of the value component of the dialog when is intially shown.
Returns the value of the value component of the dialog when it was closed.
The range of valid numbers for value is 0.0 to 1.0.</comment>
</property>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
<property>
<name>RGB</name>
<returntype>int</returntype>
<parameter>
<name>color</name>
<type>int</type>
</parameter>
<comment>Sets the value of the red, green and blue components of the dialog when is intially shown.
Returns the color of the red, green and blue components of the dialog when it was closed.
Alpha of the provided color is ignored on set and implicitly set to 255 (opaque) on get.</comment>
</property>
<property>
<name>Saturation</name>
<returntype>float</returntype>
<parameter>
<name>saturation</name>
<type>float</type>
</parameter>
<comment>Sets the value of the saturation component of the dialog when is intially shown.
Returns the value of the saturation component of the dialog when it was closed.
The range of valid numbers for saturation is 0.0 to 1.0.</comment>
</property>
<property>
<name>Hue</name>
<returntype>float</returntype>
<parameter>
<name>hue</name>
<type>float</type>
</parameter>
<comment>Sets the value of the hue component of the dialog when is intially shown.
Returns the value of the hue component of the dialog when it was closed.
The range of valid numbers for hue is 0.0 to 360.0.</comment>
</property>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.ColorPickerDialog</name>
<shortname>ColorPickerDialog</shortname>
<comment>This modal dialog allows the user to select a colour from a palette of colours.
The color may be from a standard palette in the dialog or a custom programmed palette.</comment>
<owner>activity</owner>
<method>
<name>ARGB</name>
<comment>Returns an integer value representing the color built from the chosen color and with the specified alpha value.
Alpha - A value between 0 to 255 where 0 is fully transparent and 255 is fully opaque.</comment>
<returntype>int</returntype>
<parameter>
<name>alpha</name>
<type>int</type>
</parameter>
</method>
<method>
<name>SetPaletteAt</name>
<comment>Sets the value of the color at the specified index in the current palette.
This allows replacing just one or two colors without defining an entire palette.</comment>
<returntype>void</returntype>
<parameter>
<name>index</name>
<type>int</type>
</parameter>
<parameter>
<name>color</name>
<type>int</type>
</parameter>
</method>
<method>
<name>Show</name>
<comment>Shows a modal color picker dialog with the specified title.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<method>
<name>ResetPalette</name>
<comment>Reset the palette of colors to the standard palette of the dialog.</comment>
<returntype>void</returntype>
</method>
<method>
<name>GetPaletteAt</name>
<comment>Gets the value of the color at the specified index in the current palette.</comment>
<returntype>int</returntype>
<parameter>
<name>index</name>
<type>int</type>
</parameter>
</method>
<property>
<name>Palette</name>
<returntype>int[]</returntype>
<parameter>
<name>palette</name>
<type>int[]</type>
</parameter>
<comment>Copies the colours in the array provided to the palette of colors in the dialog.
The provided array should contain 15 colors.
Returns an integer array that is a copy of the present palette.</comment>
</property>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
<property>
<name>RGB</name>
<returntype>int</returntype>
<parameter>
<name>color</name>
<type>int</type>
</parameter>
<comment>Sets the value of the chosen color of the dialog when is intially shown.
Returns the value of the chosen color of the dialog when it was closed.</comment>
</property>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.NumberDialog</name>
<shortname>NumberDialog</shortname>
<comment>This configurable modal dialog allows the user to enter a number.
The dialog is configurable to show any number of digits between a minimum of one and a maximum of eight.
The display of a decimal point is optional and the character displayed as the decimal indicator is configurable.
Note that the number accepted and returned by the dialog is an integer value and so may need scaling appropriately.</comment>
<owner>activity</owner>
<method>
<name>Show</name>
<comment>Shows a modal number picker dialog with the specified title.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<property>
<name>DecimalChar</name>
<returntype>char</returntype>
<parameter>
<name>decimalchar</name>
<type>char</type>
</parameter>
<comment>Gets or sets the displayed decimal character in the dialog.
The default is ".".</comment>
</property>
<property>
<name>Decimal</name>
<returntype>int</returntype>
<parameter>
<name>digits</name>
<type>int</type>
</parameter>
<comment>Gets or sets the position of a displayed decimal point in the dialog.
Zero displays no decimals, one indicates a single decimal, and so on.</comment>
</property>
<property>
<name>Number</name>
<returntype>int</returntype>
<parameter>
<name>number</name>
<type>int</type>
</parameter>
<comment>Sets the number initially displayed in the dialog when it is shown.
If the number is negative and ShowSign is False then the absolute value is displayed
Gets the number entered by the user after the dialog is closed.
If ShowSign is True the sign of the number corresponds to the sign entered by the user.</comment>
</property>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Digits</name>
<returntype>int</returntype>
<parameter>
<name>digits</name>
<type>int</type>
</parameter>
<comment>Gets or sets the number of digits displayed in the dialog when it is open.
One is the minimum, nine is the maximum. The default is five.
If ShowSign is True then the leftmost digit will display a "+" or "-".</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
<property>
<name>ShowSign</name>
<returntype>boolean</returntype>
<parameter>
<name>show</name>
<type>boolean</type>
</parameter>
<comment>Gets or sets whether the displayed number includes a sign character.
The default is False, no absolute value of the input number is displayed.</comment>
</property>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.FileDialog</name>
<shortname>FileDialog</shortname>
<comment>This modal dialog allows the user to choose a folder and choose or enter a filename.</comment>
<owner>activity</owner>
<method>
<name>Show</name>
<comment>Shows a modal file dialog with the specified title.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>Title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<property>
<name>ChosenName</name>
<returntype>java.lang.String</returntype>
<parameter>
<name>filename</name>
<type>java.lang.String</type>
</parameter>
<comment>Sets the filename initially shown to the user.
Returns the filename entered or chosen by the user.</comment>
</property>
<property>
<name>ShowOnlyFolders</name>
<returntype>boolean</returntype>
<parameter>
<name>onlyfolders</name>
<type>boolean</type>
</parameter>
<comment>Gets or sets whether to show only folders and not files in the dialog.</comment>
</property>
<property>
<name>ScrollingBackgroundColor</name>
<returntype>int</returntype>
<parameter>
<name>scrollcolor</name>
<type>int</type>
</parameter>
<comment>Gets or sets the background color that will be used while scrolling the list.
This is an optimization done to make the scrolling smoother.
Set to Colors.Transparent if the background behind the list is not solid color.
The default whatever is the default for the particular device</comment>
</property>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>FileFilter</name>
<returntype>java.lang.String</returntype>
<parameter>
<name>filetype</name>
<type>java.lang.String</type>
</parameter>
<comment>Gets or sets the filter values of the dialog.
The filter can be a single value ".txt"
The filter can also be a comma separated list of values ".jpg,.png".
Note that spaces in filter values are significant and are not ignored.
If a filename contains the text of a filter value the file will be displayed.
A value of an empty string, the default, will show all files.</comment>
</property>
<property>
<name>FilePath</name>
<returntype>java.lang.String</returntype>
<parameter>
<name>path</name>
<type>java.lang.String</type>
</parameter>
<comment>Sets the file path of the dialog when it is intially shown.
Returns the file path of the dialog when it is closed.
Note that setting the file path also sets ChosenName to an empty string.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
<property>
<name>FastScroll</name>
<returntype>boolean</returntype>
<parameter>
<name>fastscroll</name>
<type>boolean</type>
</parameter>
<comment>Gets or sets whether the fast scroll thumb is displayed by the dialog.</comment>
</property>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.CustomDialog</name>
<shortname>CustomDialog</shortname>
<comment>This modal dialog displays a custom set of controls laid out on a Basic4android Panel.
The Panel is displayed at an abolute position and size within the dialog.</comment>
<owner>activity</owner>
<method>
<name>AddView</name>
<comment>Adds the custom layout view, most probably a Panel, to the custom dialog.
Although named AddView to match Basic4androd syntax only one view can be added.
Adding a view replaces any existing view previously added to the dialog.</comment>
<returntype>void</returntype>
<parameter>
<name>view</name>
<type>android.view.View</type>
</parameter>
<parameter>
<name>left</name>
<type>int</type>
</parameter>
<parameter>
<name>top</name>
<type>int</type>
</parameter>
<parameter>
<name>width</name>
<type>int</type>
</parameter>
<parameter>
<name>height</name>
<type>int</type>
</parameter>
</method>
<method>
<name>Show</name>
<comment>Shows a modal custom dialog with the specified title.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>Title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
</class>
<class>
<name>anywheresoftware.b4a.agraham.dialogs.InputDialog.CustomDialog2</name>
<shortname>CustomDialog2</shortname>
<comment>This modal dialog displays a custom set of controls laid out on a Basic4android Panel.
The Panel will be automatically centred in the displayed dialog.</comment>
<owner>activity</owner>
<method>
<name>AddView</name>
<comment>Adds the custom layout view, most probably a Panel, to the custom dialog.
Although named AddView to match Basic4androd syntax only one view can be added.
Adding a view replaces any existing view previously added to the dialog.</comment>
<returntype>void</returntype>
<parameter>
<name>view</name>
<type>android.view.View</type>
</parameter>
<parameter>
<name>width</name>
<type>int</type>
</parameter>
<parameter>
<name>height</name>
<type>int</type>
</parameter>
</method>
<method>
<name>Show</name>
<comment>Shows a modal custom dialog with the specified title.
Title - The dialog title.
Positive - The text to show for the "positive" button. Pass "" if you don't want to show the button.
Cancel - The text to show for the "cancel" button. Pass "" if you don't want to show the button.
Negative - The text to show for the "negative" button. Pass "" if you don't want to show the button.
Icon - A bitmap that will be drawn near the title. Pass Null if you don't want to show an icon.
Returns one of the DialogResponse values.</comment>
<returntype>int</returntype>
<parameter>
<name>Title</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Positive</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Cancel</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>Negative</name>
<type>java.lang.String</type>
</parameter>
<parameter>
<name>ba</name>
<type>anywheresoftware.b4a.BA</type>
</parameter>
<parameter>
<name>icon</name>
<type>android.graphics.Bitmap</type>
</parameter>
</method>
<property>
<name>Response</name>
<returntype>int</returntype>
<comment>Returns the response code that the dialog returned when it last closed.</comment>
</property>
<property>
<name>Version</name>
<returntype>double</returntype>
<comment>Returns the version of the library.</comment>
</property>
</class>
<version>2.96</version>
<comment>This library contains several modal, that is blocking, dialogs by which the user
can enter data. Presently they are an InputDialog for text, a TimeDialog for times,
a DateDialog for dates, both a ColorDialog and a ColorPickerDialog for colors, a
NumberDialog for numbers,a FileDialog for folders and file names and a CustomDialog.
Android does not provide modal dialogs but a special mechanism to permit this exists
in Basic4android. The Android Activity lifetime system makes this support complicated
because Activities can be created and destroyed at will by the OS. To avoid stack
runaway on the GUI thread when an Activity is destroyed the stack must be unwound to
the lowest level. The Basic4android modal mechanism does this by closing any modal
dialog being shown and exiting the Sub that called the dialog, and any Sub that called
that Sub and so on, in order to return the main thread to the message loop. This means
that the application does not necessarily receive a return value from the dialog and has
its expected flow of execution interrupted. This will probably most often happen if the
device is rotated while a modal dialog is displayed so the Activity is destroyed and rebuilt
with a new layout.
Because this may happen unexpectedly applications, depending upon their logical structure,
may need code in the Pause and Resume Subs to deal with the fact that modal dialog closure
may not always be detected. Setting a process global when a modal dialog is shown and
clearing it when it returns with some checking code in the Resume Sub is one way of dealing
with this possibility.
The above discussion also applies the Basic4android modal dialogs InputList, InputMultiList,
Msgbox and Msgbox2.</comment>
<author>Andrew Graham</author>
</root>