xtd::forms::message Struct Reference

Inheritance diagram for xtd::forms::message:

Definition

Implements a Windows message.

Header

#include <xtd/forms/message>

Namespace

xtd::forms

Library

xtd.forms

Remarks

The message structure wraps messages that Windows sends. You can use this structure to wrap a message and assign it to the window procedure to be dispatched. You can also use this structure to get information about a message the system sends to your application or controls.

You cannot create the message directly. Instead, use the create method. For the sake of efficiency, the message uses its pool of existing Messages instead of instantiating a new one, if possible. However, if a message is not available in the pool, a new one is instantiated.

Windows message are simulate on macOS and linux.

Public Properties
xtd::intptr	hwnd
	Gets or sets the window handle of the message.
xtd::uint32	msg
	Gets or sets the ID number for the message.
xtd::intptr	wparam
	Gets or sets the wparam field of the message.
xtd::intptr	lparam
	Sets the lparam field of the message.
xtd::intptr	result
	Gets or sets the value that is returned to Windows in response to handling the message.

Public Methods
auto	equals (const xtd::object &obj) const noexcept -> bool override
	Determines whether the specified object is equal to the current object.
auto	equals (const message &other) const noexcept -> bool override
	Determines whether the specified object is equal to the current object.
auto	get_hash_code () const noexcept -> xtd::usize override
	Serves as a hash function for a particular type.
template<typename type_t>
auto	get_lparam () const noexcept -> type_t
	Gets the lparam value and converts the value to an object.
auto	to_msg_string () const noexcept -> xtd::string
	Returns a string that represents the msg property.
auto	to_string () const noexcept -> xtd::string override
	Returns a string that represents the current message.

Public Static Methods
static auto	create (xtd::intptr hwnd, xtd::uint32 msg, xtd::intptr wparam, xtd::intptr lparam) -> message
	Creates a new message.

Additional Inherited Members
	object ()=default
	Create a new instance of the ultimate base class object.
virtual auto	get_type () const noexcept -> type_object
	Gets the type of the current instance.
template<typename object_t>
auto	memberwise_clone () const -> xtd::unique_ptr_object< object_t >
	Creates a shallow copy of the current object.
virtual auto	equals (const message &) const noexcept -> bool=0
	Indicates whether the current object is equal to another object of the same type.
template<typename object_a_t, typename object_b_t>
static auto	equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are considered equal.
template<typename object_a_t, typename object_b_t>
static auto	reference_equals (const object_a_t &object_a, const object_b_t &object_b) noexcept -> bool
	Determines whether the specified object instances are the same instance.

Member Function Documentation

equals() [1/2]

auto xtd::forms::message::equals ( const xtd::object & obj ) const -> bool

nodiscardoverridevirtualnoexcept

Determines whether the specified object is equal to the current object.

Parameters

obj	The object to compare with the current object.

Returns

true if the specified object is equal to the current object. otherwise, false.

Reimplemented from xtd::object.

equals() [2/2]

auto xtd::forms::message::equals ( const message & other ) const -> bool

nodiscardoverridenoexcept

Determines whether the specified object is equal to the current object.

Parameters

other

The object to compare with the current object.

Returns

true if the specified object is equal to the current object. otherwise, false.

get_hash_code()

auto xtd::forms::message::get_hash_code ( ) const -> xtd::usize

nodiscardoverridevirtualnoexcept

Serves as a hash function for a particular type.

Returns

A hash code for the current object.

Reimplemented from xtd::object.

get_lparam()

template<typename type_t>

auto xtd::forms::message::get_lparam ( ) const -> type_t

inlinenodiscardnoexcept

Gets the lparam value and converts the value to an object.

Template Parameters

type	The type to use to create an instance. This type must be declared as a structure type.

Returns

An object that represents an instance of the class specified by the template parameter, with the data from the lparam field of the message.

to_msg_string()

auto xtd::forms::message::to_msg_string ( ) const -> xtd::string

nodiscardnoexcept

Returns a string that represents the msg property.

Returns

A xtd::string that represents the msg property.

to_string()

auto xtd::forms::message::to_string ( ) const -> xtd::string

nodiscardoverridevirtualnoexcept

Returns a string that represents the current message.

Returns

A xtd::string that represents the current message.

Reimplemented from xtd::object.

create()

auto xtd::forms::message::create ( xtd::intptr hwnd, xtd::uint32 msg, xtd::intptr wparam, xtd::intptr lparam ) -> message

staticnodiscard

Creates a new message.

Parameters

hwnd	The window handle that the message is for.
msg	The message ID.The message ID.
wparam	The message wparam field.
lparam	The message lparam field.

Returns

A xtd::forms::message that represents the message that was created.

Remarks

Use the xtd::message::create method to create a xtd::forms::message to wrap a message sent by Windows.

Member Data Documentation

hwnd

xtd::intptr xtd::forms::message::hwnd

Gets or sets the window handle of the message.

Parameters

hwnd	The window handle of the message.

Remarks

Window handle is a value that uniquely identifies a window on the system. This property returns a handle of the window whose window procedure receives this message. It is useful when your code need to interact with some native Windows API functions that expect window handles as parameters.

msg

xtd::uint32 xtd::forms::message::msg

Gets or sets the ID number for the message.

Parameters

msg	The ID number for the message.

wparam

xtd::intptr xtd::forms::message::wparam

Gets or sets the wparam field of the message.

Parameters

wparam

The wparam field of the message.

Remarks

The value of this field depends on the message. Use the wparam field to get information that is important to handling the message. This field is typically used to store small pieces of information, such as flags.

lparam

xtd::intptr xtd::forms::message::lparam

Sets the lparam field of the message.

Parameters

lparam

The lparam field of the message.

Remarks

The value of this field depends on the message. Use the lparam field to get information that is important for handling the message. lparam is typically used to store an object if it is needed by the message.

result

xtd::intptr xtd::forms::message::result

Gets or sets the value that is returned to Windows in response to handling the message.

Parameters

result

The return value of the message.

---

The documentation for this struct was generated from the following file:

• xtd.forms/include/xtd/forms/message.hpp