Popup Commands
NOTE: Some popup commands will make exceptions to Repeat Events and some will not. The actions have been intentionally crafted to do what the typical user will want in almost all cases. This is what happens in V-4.3.16 and later:
The
Delete command, Advance Date and Toggle commands (Toggle status, Toggle type, Toggle
alarm) will make an exception if the event(s) is a repeat series and the checkbox Make Exceptions: Delete,Advance & Toggle is checked (the default condition whenever the dialog is displayed or refreshed). If you uncheck this
checkbox immediately prior to issuing the command, then the Delete,
Advance and Toggle commands will apply to the entire repeat series and
no exceptions will be made. See the reference list below which
specifically identifies which popup commands are capable of making
exceptions.
When making an exception to a repeat series, If
the
event selection list was not for a particular day (such as would be the
case from a Find function or upcoming alarms list, etc.), then the next
instance of the repeat on or after today's date will be used to set the
Exception date. Otherwise, the exception is made on the date for which
the Event Selection List was created.
So if you want the Delete, Advance or Toggle Command
functionality to apply to the entire repeat series, you should either
(a) call up the event in the Edit Dialog (indicating that you want the
actions to apply to the entire repeat series) to make the change, or
(b) select the item(s) you want
to apply to the entire series, and uncheck the checkbox: Make Exceptions: Delete, Advance & Toggle.
Some
of these commands only appear when a single item is selected, while
other commands can be used when multiple items are selected (using the
Multi-Select button). Items which can appear in the multiple selection
list have a plus (+) sign after the command in the list below.
Not all commands are necessarily listed because preferences control both which items display and the order in which items appear (just like the main menu). If you are looking for an item that does not appear, then edit the preference: PopupListCommandsForEvent (and/or PopupListCommandsForMultiSelect) which controls what items appear in the lists and in what order. You can also tap the Show All button to display ALL the popup commands in that list (regardless of whether the items are marked for display or normally hidden).
If a deleted item is selected, a dialog appears reminding you that you must first EDIT the item to remove the deleted status (if you click on OK in the Edit dialog, even without making any change, the deleted status will get removed). If you are in multi-select mode and a deleted item is selected with a long-press, a dialog appears allowing you to undelete ALL selected items.
POPUP Commands that Can Make Exceptions to Repeat series
Regardless of whether in single select or multi-select mode, these commands will make an exception to a repeat series if the checkbox: Make Exceptions: Delete, Advance & Toggle is checked (and by default, it is always checked on entry to an Event Selection List). To have the command apply to the entire repeat series, uncheck this box immediately prior to issuing the popup command.
Advance 1 Day +
The item's date is advanced by one day.
Advance 1 week +
As above, except the period for advancement is one week.
Advance To Monday (or Tuesday, Wednesday...) +
As above, except the item is advanced to the next, specified day of the week
Advance to Today +
As above, except the item is always moved to today's date
Advance to First of Next Month +
As above, except the item is moved to the first day of the next month
Shift Times Forwards/Backwards +
All selected item(s) can be advanced forwards or backwards by any number of weeks/days/hours/minutes. If the item is untimed, the item is only shifted by days and it remains untimed. This shift is done intelligently, in that other date fields, such as due dates, repeat end dates, etc. are also shifted by this command.
Change Date +
The start date (and time) of all selected item(s) is set to the new, selected date. The end date is automatically adjusted to preserve the duration of the event. Similar changes are made to the repeat specification (on repeat items) to ensure the repeat is still viable (for example, if a weekly repeat, the day of the week is adjusted to reflect the new date). Note that if you have multiple events on different dates, this command will move them to the SAME date. If you want to just shift the events by a number of days, use the Shift Times Forwards/Backwards command instead.
Toggle Completion +
If the item had a normal status, it is now marked as complete, and if complete, it is now marked as normal.
Toggle Cancellation +
If the item was not canceled, it is now marked as canceled, and if canceled, it is now marked as normal.
Toggle Absent +
Toggle the status of the event to Absent (from whatever the current status is) and back to Normal.
Toggle Alarm +
Toggles the Alarm on the selected item. If there is no alarm, a single alarm is set at the event time. if the item already has one or more alarms, all alarms are removed.
Toggle Private +
If the item(s) was marked as private, it is now marked as non-private, otherwise, the item(s) is made private.
Toggle Busy
If the item(s) had a Type field of Busy, it is changed to Free. Otherwise if any other Type (Tentative, Free or Out of Office), it is changed to Busy.
Delete +
Deletes the item. By default a confirmation dialog is displayed (can be turned off with a preference setting). Normally, If the item is a repeat event, only the current instance of that event is deleted. If you want to delete the entire series, you need to tap on the item in the Event Selection list and then delete it in the Edit Dialog (which will delete the entire series if All was selected in the Repeat Exception Dialog, or if the item has never been synced - in which case all changes are made as if All had been selected.
If you are deleting multiple items, what happens with repeat items depends on the setting of the Checkbox: Make Exceptions for Delete & Toggle Commands. If checked, exceptions will be made to each repeat item, otherwise the entire series will be deleted.
POPUP Commands that NEVER Make Exceptions to Repeat Series
These commands will always apply to the entire repeat series and never make an exception (regardless of the setting of the Make Exceptions..... checkbox).Makes a copy of the item that is identical in every way except that exceptions to a repeat event are purged, and if the item was marked as Canceled or Completed it will be returned to a normal status. The Edit dialog then appears so any changes can be made to the copy. At this time, remember that duplicating a floating reminder will result in two floats with the SAME target event, and under these conditions and following syncing, it's likely that any previous reminder pointing to the same target event will be removed (in future it is likely that the target event field will be cleared when the duplicate command is used). If you are changing a repeat event to a non-repeat event, remove the repeat status first before making any other changes (in particular do this before changing the date of the event).
Find All Items in Group
If the item is in a group, then all items that are also in that same group are now displayed in a new event selection list.
Go To Display/Due Date
If the item is a normal event, the current view is redisplayed with that day showing as part of the view. If the item is a repeat series, the start date of the repeat series sets the day for display.
There
are “free-standing” floats that have no target event, and which may
have an optional DUE date. These would normally be floating events
created directly by the user.
Go to Display/Due Date will then
(a) if there is a due date, go to the Due date, or (b) if there is no
due date, go to the display date of the Floating event.
There
are “Advance Reminders” (which are also just floating events), but they
are typically created by Pimlical itself as advances on a “target”
event. Such events have a pointer to the event that spawned the
advance, so they have a target date which is the date of the original event that spawned the reminder.
Go To Display/Due Date will then (a) go to the DUE Date if there is a due date, or (b) if there is no Due Date and there is a target event (which still exists) go to the start
date of the target event. If the reminder was generated as an advance on a repeat series, the date would
be the start date of the repeat series) or (c) if there is no Due date and no valid target event, it will then go to the display date of the Float itself.
Save as Template +
The item is saved as a quick entry template. You can edit or delete the quick entry template from the Event Selection Dialog.
Set Link to Contact Record
When selected, the built-in contacts application is invoked to display a list of all your contacts. Select the contact that you want to link to. To remove the link, go into the Edit Dialog and click on Edit Links and remove the link.
Set Link to Memo
When selected, a list of all your memos is displayed.. Select the memo that you want to link to. To remove the link, go into the Edit Dialog and click on Edit Links and remove the link.
Set Link to File
This command opens up a File Navigation dialog that allows you to browse through files in the local filing system on your Android Device. At the top of the list (if applicable) will be the parent folder, indicated with two periods. Below that are all the files and sub-folders in that folder. Folders always start with a slash character so they can be easily distinguished from files and generally appear at the top of the list (everything is sorted into alphanumeric order). When you tap on a file to select it, Pimlical automatically appends the tag FILE:// and the full path to the file you selected to the end of the note field. Tapping on the LINK icon will automatically launch an application that can manage that particular file type to display/play/activate/edit that file (what actually happens is a function of the file type you selected, and the configuration of your Android system of course). A typical use of this function might be to link a photograph to an item, or to link an MP3 sound file to an item etc. You can have any number of links to files set for a single event.Set Link to URL
This command opens up a dialog into which you can enter a full URL (Universal Resource Locator). Normally, you will want to first add a tag and a comma first so the link can be identified (as many URL's can be inscrutable). Typically, you would find a web page and use the COPY function to copy the entire URL to the clipboard and then just paste it into the text field, rather than manually typing it in. You can also use the MailTo: tag to launch your email program for a URL.Show Linked Contact (and/or memos)
If the selected item has a linked contact or memo, the contact details or memo will then be displayed. If there are two or more linked items, a list is presented of all links so you can pick the link you want. Memos have the legend (Memo) ahead of the link to identify them from contacts.
Show Meeting Attendees
If there are attendees to a designated meeting, the attendees are displayed and you can add/remove/email attendees, etc.
Show All Repeat Instances
This command will find all instances of a repeat - most importantly it will find all the exceptions to a repeat series whether created by editing just an instance, or by using the irregular repeat feature. You can select either the repeat series itself, or any instance of the repeat series to find all the other occurrences. Note that the instances of an irregular repeat series are separate events, but in Multi-Select mode you can apply changes to all the instances directly.
Share Event Text +
The text of the selected item is presented to any Android application that can handle the sharing of plain text. The actual information from the selected item is formatted by a template (sharedetailstemplate.txt in the Pimlical Folder - see help section Share Details Template on the format of this template if you are a power user and wish to change it).
Forwards/Backwards by Date
When selected, the advance Time Picker dialog (Duration dialog) appears so you can pick a date based upon it being some number of days/weeks/months before (negative value) or after (positive value) the date in the Event Selection List. If the list is not associated with a specific day (i.e. it was displayed to show upcoming alarms, items linking to a contact, etc.) then today's date is used as the basis for the offset. This is handy when you want to schedule an appointment say 180 days after the last appointment.
Remove Snooze Alarm +
When selected, this command will remove all pending snooze alarms associated with the selected event. No other alarms, or snoozed alarms on other events are affected by this command.
Copy Selected Item(s) +
This command copies the selected event(s) into a special list from which it can be subsequently pasted. Existing items that may already be in the list are not affected by this command. This command can be used to copy one or more items (multi-select mode) between different calendars. For example, it can be used to retrieve items that were inadvertently purged: just select the PimlicalArchiveCalendar and add all the items you want to restore to the list, switch back to the local calendar and then paste them back into the calendar. The multi-select button is especially useful for this function as it makes it easy to quickly select a group of items in an event selection list.
Note: the commands to copy and paste items should be used in a single session as the clipboard that remembers these items is not persistent (i.e. don't copy an item and come back two days later to try and paste it and expect it to still be there!).
Copy ALL Items In List
This command copies all the events in the current list into a special list from which it can be subsequently pasted. Existing items that may already be in the list are not affected by this command. This is equivalent to using Multi-Select Mode with all items selected and then using the COPY SELECTED ITEM(s) command.
Clear Copy Items List
This command clears the special list from which items can be subsequently pasted. Note that copying and pasting items never clears the list, so you need to use this command before starting a new set of copy/paste functions.
Paste Items
This command pastes all the items that were previously copied into the special list with the Copy Selected Item and Copy All Items In Lis commands.
Share Calendar Event +
This command will share either one event or, in multi-selection mode, multiple events with any application that can handle file attachments - in most cases you would likely select an email application, but any application that presents itself in the subsequent selection screen can be used. The events are written into a standard iCalendar file with the filename Pimlical_Calendar_Events.ics. This file is also stored in the Pimlical folder on the Android device.Compare Calendar Events +
This command can only be used in Multi-select mode when two items are selected. Pimlical will then compare the two events and note every single discrepancy between them. This can be helpful in diagnosing issues with duplicate events (i.e. they may look similar, but what exactly is different about them?).Change Timezone +
The timezone of all selected item(s) can be set to a new timezone value. This adjusts both the Start and End Times to that timezone, and if the item is a floating event or task, it will also change the timezone of the due date.Change Category +
The category (or calendar) of all selected item(s) can be set to a new calendar or category. This command is only permitted if the preference MultipleCategorySelection is set to its default value of False. If a calendar is selected (i.e. it has the A_ prefix on its name), then the item is MOVED into that calendar and removed from the old calendar (or if it is moved from an Android calendar to the Local calendar).The priority of all selected item(s) is set to the new, selected priority level
Change Urgency +
The urgency of all selected item(s) is set to the new, selected urgency level
Change Group +
The group selection(s) of all selected item(s) is set to the new, selected set of groups.
Change Color +
The foreground and background color selection(s) of all selected item(s) are set to the new, selected color.
Change Font +
The custom Font selection(s) of all selected item(s) is set to the new, selected custom font.
Change Time (Subscription Feature)Changes the time of all selected item(s) to the designated time. The date is unchanged..
Copy DescriptionCopies the description of the selected event to the Android system clipboard.
Copy Note
Copies the note of the selected event to the Android system clipboard.
Copy LocationCopies the Location field of the selected event to the Android system clipboard.
Set Meeting Status
Displays a selection dialog of Status Types for the Meeting dialog and then sets the status type of all the participants in that meeting to that value (except for the Chair/Organizer whose status remains unchanged by this command).
Set Meeting Role
Displays a selection dialog of Roles for the Meeting dialog and then sets the role of all the participants in that meeting to that value (except for the Chair/Organizer whose role remains unchanged by this command).
Show Meeting Attendees
Displays a list of all the Attendees for the meeting associated with the selected event.
Link to Master+ (Subscription Feature)
To use this command, one (and only one) of the selected events should be designated as the Master event by using the Action Tag: Master Template. Pimlical will then link all the other events to this Master event and mark them as subordinate events. The Master Event will display the Master Event Icon [M] and the subordinate events will display the Subordinate Event Icon [S]. You can use the popup command below to quickly get an event selection list of all the linked events. You can also then use the Save As Template popup command to save this as a Master/Subordinate template group which facilitates the rapid insertion of multiple events.Find all Linked Events (Subscription Feature)
When issued on a master or subordinate event, all linked events are displayed in an Event Selection List.
Set Snooze Alarm (Subscription Feature)
When issued on an event, a snooze alarm is set at the designated future time interval, even if no alarm is set on the event. Furthermore, if the event did have a future alarm set, it will be suppressed if that alarm would trigger before the time set by this popup command. This is useful in two cases: (a) you have an event with no alarm set and rather than editing the event, you can just force a snooze alarm on the event quickly, and (b) you have an alarm that is going to trigger say in 30 minutes, and you know you are going to have to snooze it then for an hour - so with this new command you can snooze it immediately for 1h30m and not be bothered in 30 minutes.
Search and Replace+ (Subscription Feature)
Search and replace makes it easy to replace one text string in the calendar database with another. This command can be usefully used in Multi-Select mode to change a text string in multiple events. When invoked, a dialog appears with a text field into which two text strings can be entered (use the Enter key at the end of the first text string to enter the second text string. After entering the two text strings, you can then tap one of three buttons: Description Only - this button indicates that only the Description field of the event should be searched for the first text string; Choose Text Fields - this button will bring up a dialog where you can select which text fields you want examined for the Search And Replace operation: Description, Note, Location, Group, Custom 1, Custom 2, Custom 3, Custom 4; Append - this button will just append the text in the input text field to the end of the description field of every selected event in the Event Selection List. To cancel out of this dialog, just use the back button.
To search the entire database, you can use Menu | Find | Clear | OK, then long-press the multi-select button and long-press any single event and select the popup command Search And Replace - that allows you to perform the operation on every single event in the entire calendar. Note that you may want to backup the calendar first in case you inadvertently end up making inadverent changes!
Also, whilst this command does not cater to word searches, remember that find does. So if you wanted to change all occurrences of Cat to Dog, and didn't want words like cater or catastrophe to be changed, do the find first for Cat with the checkbox for Words checked, and that way you would avoid this issue.
POPUP Commands that are Primarily for Testing, Debugging & Diagnosing Problems
Event Attributes +
Takes all the information for the selected event(s) and creates a text file in the Pimlical folder with all the attributes of those events. Always use this command when contacting Tech Support with an issue about a specific event.
Internal Record Details
Displays internal information for the selected item, primarily for debugging/testing - not normally displayed by default. For example, if you needed to know precisely WHEN the item was created, you can use this command to view the creation date of the item.
Edit Link Field
Displays the contents of the Link field (links to contacts/memos/files/URL's) in an editable field. Not normally used, but if you had a long URL link and needed to make just a tiny change, this would be faster than deleting the link and trying to reproduce it.Display Details
Displays all the attributes of an event using an editable (but only for real power users!) screen template. When the Details display is shown, you can use an upstroke on the screen to move to the next event on the current day, or a downstroke to move to the prior event on the current day. A short tap dismisses the Event Details Screen, while a long press will bring up the Edit Dialog for the selected event.
The format of the screen template is covered in the appendix of the Pimlical/Desktop Reference manual: www.pimlicosoftware.com/pimlical-manual.pdf.
Customizing the Popup Command List
see Preference: PopupListCommandsForEvent in the section: [Commands and Functions] to select which commands you want to see and in what order they are displayed). If you use a certain command very frequently (such as Show Linked Contact) you may wish to move that to the top of the list so you can access it quickly without scrolling.
There is a separate preference, PopupListCommandsForMultiSelect which defines which popup commands are available when multiple items are selected (this list is different because some functions such as Display Details would make no sense with multiple items selected.