This Settings screen allows you to configure some of the attributes for the widget. This configuration screen displays on installation of the widget, or when the Pimlical logo (at top left) is tapped. This widget will work with both the standard Android calendar as well as Pimlico Software's local calendar. For more Information on Pimlical/Android - a Personal Information Manager that supports advanced calendar functions as well as a local contacts and memos database on both Android and Windows Desktops, see www.pimlicosoftware.com
The Settings dialog displays the current version of the Widget in the title bar of the dialog (in the example above, the version is 3.5.6).
The attributes you can set are:
Refresh intervalThis setting determines how often the widget re-reads the calendar. The widget only refreshes when the device is powered on, so setting even a short interval of a minute or two should not impact battery usage significantly. When refreshing pimlical will read all the currently selected Android calendars as well as Pimlical/Android's local calendar (if present). You can actually set any value you like for this item by going into P/A and adjusting the Preference: WidgetRefreshInterval.
Text RowsThe widget can display from 1 to 20 text rows (one text row for each event/task) depending on the available space. The default setting is Auto which attempts to calculate a reasonable number of rows for the display. It is quite likely that you will want to set a precise value which is optimal for your particular device - in that case, tap OK and look at the widget to see how many text rows would fit (don't forget that there is a row at the bottom for the next, upcoming alarm). Then tap the Pimlical logo and this time use the dropdown list to set the optimal number of rows for the display. The widget is resizable (after tapping OK in the Settings screen, long-press the widget and resize handles will appear that allow you to resize the widget both horizontally and vertically). Some Android devices, (such as Samsung) have proprietary code in the Android OS and may require a fixed setting. If you have the number of rows set to Auto and the size does not appear to be correct on installation, try tap&hold (which invokes resize handles) and release (some Samsung devices then report the correct size and will expand to fill the space). If that fails to set the correct number of text rows, pick an appropriate, explicit value from the dropdown list.
TransparencyThis setting controls the transparency of the background of the widget. A value of 0 is totally opaque, while 100 would be totally transparent. You can adjust the transparency either by moving the slider, or tapping the button and keying in an exact value. Some Android devices don't handle transparency properly due to failure to properly implement the Android OS and instead just display an opaque background. There is no workaround for this issue at this time.
TypesizeThis dropdown list sets the typesize for the text displayed in the widget. Whatever size you pick is used for the description fields. The date line at top and alarm line at bottom are scaled to approximately 110% of whatever value you pick for the description lines. if you use a typesize of 12 or less, the full date is displayed (Monday, January 1, 2016). If you pick 13 or 14, only the first three letters of the day of week and month are displayed (Mon, Jan 1 2016). If 16/18/20, then the date is displayed in medium format (1/1/2016) and if a fontsize larger than 24 is selected, then only the month and day are displayed (1/1).
12 Hour ClockCheck this box to display times in 12 hour format with am/pm indicator. Uncheck the box to display times in 24-hour format.
By default, Pimlical displays all the text with black type. Check this box to use white for the type instead - this may work better when using a transparent background over a dark graphic.
Show Quick Entry Template Button [Q]The widget can optionally display a button that will invoke Pimlical's Template Dialog, so you can enter a new event by using a Pimlical/Android Template. By default, this button is not displayed.
Hide All Top Row Widget ButtonsIf this checkbox is checked, all the top row buttons in the Widget are hidden. To restore those buttons, you will of course have to remove and reinstall the Widget as the only way to get to the configuration screen otherwise is to use the logo button (which this option hides!). This option may be useful to some users who want as much space as possible for the calendar and don't care about the launch functionality available in the widget itself.
The Done button applies all the current settings and launches the Widget.
The Reset button resets all the settings back to the way they were when you invoked the Settings dialog, use this if you want to exit the Settings dialog without changing anything, as it will discard any unsaved changes that you might have made.
The Info button brings up this help file that you are now reading.
The selection of events to display in the widget is actually controlled by a Pimlical Filter with the name Widget. If you have Pimlical/Android calendar installed, you can edit the filter to basically filter events in any way that you want. For example, by default the filter only includes future timed events, but you can easily change the filter to include untimed events, only include events in certain calendars or categories in the local calendar, etc. If you have Pimlical Local calendar installed, you can also choose to hide floating events and/or tasks in the widget display, or hide or display the text of private events (private events are normally masked). Or perhaps you prefer to see only floating events and tasks that are currently due and not those that are due in the future.
For even more control, you can check the box in the Repeat Tab of the Filter/Edit dialog to indicate that the Widget filter has a custom preference file - with that, the widget can have its own set of preferences completely separate from those used in Pimlical/Android (for example, you could set up Pimlical/Android to use the Short Description feature, but not use that in the widget itself, or you could hide all alarms in the Widget, but still have them display in Pimlical/Android). You may wish to do this if you are an advanced user and using custom preference files attached to filters which potentially modify the default preference settings (if you do that, the Widget will use the default preferences, and might end up displaying something different from what you expect).
Default Widget Filter Settings
Only future Items are displayed
Exclude canceled Items
Exclude completed Items
Exclude deferred items (from P/D only at this time)
Only timed events are included (Untimed/AllDay excluded)
Set date to Today's date
Date Range = up to 31 days into the future.
All these settings can be modified by editing the Widget filter in Pimlical/Android.
Trouble-ShootingIf you run into problems with the widget (especially if you were making extensive modifications to the Widget filter, etc.), you can always get back to a known good condition with this procedure: