List of FireMonkey Message Types

From RAD Studio
Jump to: navigation, search

Go Up to Using the RTL Cross-Platform Messaging Solution


This page contains a list of RTL messages that FireMonkey provides, either translated from system messages or implemented by the FireMonkey framework.

Cross-Platform Message Types

The FireMonkey framework does not send all of the following message types in every platform. For example, FireMonkey only sends messages of type TApplicationEventMessage in Android and iOS. However, these message types are declared in every platform. In those platforms where FireMonkey does not send messages of a specific type, you can still create instances of the message type.

Item Platforms
Android iOS Mac OS X Windows

TApplicationEventMessage

Supported

Supported

TBeforeStyleChangingMessage

Supported

Supported

Supported

Supported

TCanvasDestroyMessage

Supported

Supported

Supported

Supported

TContextLostMessage

Supported

Supported

Supported

Supported

TContextResetMessage

Supported

Supported

Supported

Supported

TFormReleasedMessage

Supported

Supported

Supported

Supported

TFormsCreatedMessage

Supported

Supported

Supported

Supported

TIdleMessage

Supported

Supported

Supported

Supported

TMessageDidFinishTakingImageFromCamera

Supported

TMessageDidFinishTakingImageFromLibrary

Supported

TOrientationChangedMessage

Supported

Supported

TPushDeviceTokenMessage

Supported

TPushFailToRegisterMessage

Supported

TPushRemoteNotificationMessage

Supported

TPushStartupNotificationMessage

Supported

TRadioButtonGroupMessage

Supported

Supported

Supported

Supported

TScaleChangedMessage

Supported

TSpeedButtonGroupMessage

Supported

Supported

Supported

Supported

TStartMenuLoopMessage

Supported

Supported

Supported

Supported

TStyleChangedMessage

Supported

Supported

Supported

Supported

TVKStateChangeMessage

Supported

Supported

Supported

Platform-specific Message Types

The following are message types that FireMonkey sends only on specific platforms.

Also, you can only create instances of these message types on supported platforms. You can still instantiate in any platform those message types listed here that use the TMessage generic class, such as TMessage<TNotification>, provided that the class (such as TNotification) is also defined in all platforms.

Android Message Types

Item Description

System.Messaging.TMessage<TNotification>

The Android implementation of System.Notification sends messages of this type when it detects a system notification previously scheduled using TCustomNotificationCenter.ScheduleNotification. This includes:

  • Notifications that started your application. These TMessage<TNotification> messages are sent in response to received TFormsCreatedMessage messages.
  • Notifications sent while your application was running. These TMessage<TNotification> messages are sent in response to received TMessageReceivedNotification messages.

These messages contain an instance of TNotification.

FMX.Platform.TMessageCancelReceivingImage

The Android implementation of FMX.Platform sends messages of this type when it receives a system notification about the user canceling an action to take a photo that originated in your application.

These messages contain an integer with the request code of the underlying Android intent.

FMX.Platform.TMessageReceivedImagePath

The Android implementation of FMX.Platform sends messages of this type when it receives a system notification about the user having taken a photo as a result of a call to IFMXCameraService.TakePhoto or IFMXTakenImageService.TakeImageFromLibrary, or executing an action to take a photo in your application.

These messages contain a string with the path to the taken picture.

If you call the method to obtain a picture from the device, and you do not specify an event handler for successfully obtaining a picture, this message is followed by one of the following messages:

FMX.Platform.TMessageReceivedNotification

The Android implementation of FMX.Platform sends messages of this type when it receives a system notification previously scheduled using TCustomNotificationCenter.ScheduleNotification.

These messages contain an instance of JIntent, an Android-specific RTL class that wraps an Android intent.

Note: Messages of this type are only sent while your application is running. To detect also system notifications responsible for starting your application, capture TMessage<TNotification> instead.

FMX.Platform.TMessageResultNotification

The Android implementation of FMX.Platform sends messages of this type when it receives a general-purpose system notification, that is, a system notification that is not the result of an action to take a photo that originated in your application.

These messages contain the data returned by onActivityResult in the following properties:

iOS Message Types

Item Description

System.Messaging.TMessage<TNotification>

The iOS implementation of System.Notification sends messages of this type when it detects a system notification previously scheduled using TCustomNotificationCenter.ScheduleNotification. These TMessage<TNotification> messages are sent in response to received TMessage<UILocalNotification> messages.

These messages contain an instance of TNotification.

System.Messaging.TMessage<UILocalNotification>

The iOS implementation of FMX.Platform sends messages of this type when it receives a system notification previously scheduled using TCustomNotificationCenter.ScheduleNotification.

These messages contain an instance of UILocalNotification, a class from the iOS API.

Mac OS X Message Types

Item Description

System.Messaging.TMessage<TNotification>

The Mac OS X implementation of System.Notification sends messages of this type when it detects a system notification previously scheduled using TCustomNotificationCenter.ScheduleNotification.

These messages contain an instance of TNotification.

See Also