#include <system_information.h>

Definition

Provides information about the current system environment.

Namespace: xtd::forms

Library: xtd.forms

Remarks: The system_information class provides static properties that can be used to get information about the current system environment. The class provides access to information such as Windows display element sizes, operating system settings, network availability, and the capabilities of hardware installed on the system. This class cannot be instantiated.; For more information about system-wide parameters, see "SystemParametersInfo" in the Platform SDK documentation at http://msdn.microsoft.com.

Static Public Member Functions
static int32_t	active_window_tracking_delay ()
	Gets the active window tracking delay. More...

static xtd::forms::arrange_direction	arrange_direction ()
	Gets a value that indicates the direction in which the operating system arranges minimized windows. More...

static xtd::forms::arrange_starting_position	arrange_starting_position ()
	Gets an ArrangeStartingPosition value that indicates the starting position from which the operating system arranges minimized windows. More...

static xtd::forms::boot_mode	boot_mode ()
	Gets a BootMode value that indicates the boot mode the system was started in. More...

static xtd::drawing::size	border_3d_size ()
	Gets the thickness, in pixels, of a three-dimensional (3-D) style window or system control border. More...

static int32_t	border_multiplier_factor ()
	Gets the border multiplier factor that is used when determining the thickness of a window's sizing border. More...

static xtd::drawing::size	border_size ()
	Gets the thickness, in pixels, of a flat-style window or system control border. More...

static xtd::drawing::size	caption_button_size ()
	Gets the standard size, in pixels, of a button in a window's title bar. More...

static int32_t	caption_height ()
	Gets the height, in pixels, of the standard title bar area of a window. More...

static int32_t	caret_blink_time ()
	Gets the caret blink time. More...

static int32_t	caret_width ()
	Gets the width, in pixels, of the caret in edit controls. More...

static xtd::ustring	computer_name ()
	Gets the NetBIOS computer name of the local computer. More...

static xtd::drawing::size	cursor_size ()
	Gets the maximum size, in pixels, that a cursor can occupy. More...

static bool	dbcs_enabled ()
	Gets a value indicating whether the operating system is capable of handling double-byte character set (DBCS) characters. More...

static bool	debug_os ()
	Gets a value indicating whether the debug version of USER.EXE is installed. More...

static xtd::drawing::size	double_click_size ()
	Gets the dimensions, in pixels, of the area within which the user must click twice for the operating system to consider the two clicks a double-click. More...

static int32_t	double_click_time ()
	Gets the maximum number of milliseconds that can elapse between a first click and a second click for the OS to consider the mouse action a double-click. More...

static bool	drag_full_windows ()
	Gets a value indicating whether the user has enabled full window drag. More...

static xtd::drawing::size	drag_size ()
	Gets the width and height of a rectangle centered on the point the mouse button was pressed, within which a drag operation will not begin. More...

static xtd::drawing::size	fixed_frame_border_size ()
	Gets the thickness, in pixels, of the frame border of a window that has a caption and is not resizable. More...

static int32_t	font_smoothing_contrast ()
	Gets the font smoothing contrast value used in ClearType smoothing. More...

static int32_t	font_smoothing_type ()
	Gets the current type of font smoothing. More...

static xtd::drawing::size	frame_border_size ()
	Gets the thickness, in pixels, of the resizing border that is drawn around the perimeter of a window that is being drag resized. More...

static bool	high_contrast ()
	Gets a value indicating whether the user has enabled the high-contrast mode accessibility feature. More...

static int32_t	horizontal_focus_thickness ()
	Gets the thickness of the left and right edges of the system focus rectangle, in pixels. More...

static int32_t	horizontal_resize_border_thickness ()
	Gets the thickness of the left and right edges of the sizing border around the perimeter of a window being resized, in pixels. More...

static int32_t	horizontal_scroll_bar_arrow_width ()
	Gets the width, in pixels, of the arrow bitmap on the horizontal scroll bar. More...

static int32_t	horizontal_scroll_bar_bhumb_width ()
	Gets the width, in pixels, of the scroll box in a horizontal scroll bar. More...

static int32_t	horizontal_scroll_bar_height ()
	Gets the default height, in pixels, of the horizontal scroll bar. More...

static int32_t	icon_horizontal_spacing ()
	Gets the width, in pixels, of an icon arrangement cell in large icon view. More...

static xtd::drawing::size	icon_size ()
	Gets the dimensions, in pixels, of the Windows default program icon size. More...

static xtd::drawing::size	icon_spacing_size ()
	Gets the size, in pixels, of the grid square used to arrange icons in a large-icon view. More...

static int32_t	icon_vertical_spacing ()
	Gets the height, in pixels, of an icon arrangement cell in large icon view. More...

static bool	is_active_window_tracking_enabled ()
	Gets a value indicating whether active window tracking is enabled. More...

static bool	is_combo_box_animation_enabled ()
	Gets a value indicating whether the slide-open effect for combo boxes is enabled. More...

static bool	is_drop_shadow_enabled ()
	Gets a value indicating whether the drop shadow effect is enabled. More...

static bool	is_flat_menu_enabled ()
	Gets a value indicating whether native user menus have a flat menu appearance. More...

static bool	is_font_smoothing_enabled ()
	Gets a value indicating whether font smoothing is enabled. More...

static bool	is_hot_tracking_enabled ()
	Gets a value indicating whether hot tracking of user-interface elements, such as menu names on menu bars, is enabled. More...

static bool	is_icon_title_wrapping_enabled ()
	Gets a value indicating whether icon-title wrapping is enabled. More...

static bool	is_keyboard_preferred ()
	Gets a value indicating whether the user relies on the keyboard instead of the mouse, and prefers applications to display keyboard interfaces that would otherwise be hidden. More...

static bool	is_list_box_smooth_scrolling_enabled ()
	Gets a value indicating whether the smooth-scrolling effect for list boxes is enabled. More...

static bool	is_menu_animation_enabled ()
	Gets a value indicating whether menu fade or slide animation features are enabled. More...

static bool	is_menu_fade_enabled ()
	Gets a value indicating whether menu fade animation is enabled. More...

static bool	is_minimize_restore_animation_enabled ()
	Gets a value indicating whether window minimize and restore animation is enabled. More...

static bool	is_selection_fade_enabled ()
	Gets a value indicating whether the selection fade effect is enabled. More...

static bool	is_snap_to_default_enabled ()
	Gets a value indicating whether the snap-to-default-button feature is enabled. More...

static bool	is_title_bar_gradient_enabled ()
	Gets a value indicating whether the gradient effect for window title bars is enabled. More...

static bool	is_tool_tip_animation_enabled ()
	Gets a value indicating whether tool_tip animation is enabled. More...

static int32_t	kanji_window_height ()
	Gets the height, in pixels, of the Kanji window at the bottom of the screen for double-byte character set (DBCS) versions of Windows. More...

static int32_t	keyboard_delay ()
	Gets the keyboard repeat-delay setting. More...

static int32_t	keyboard_speed ()
	Gets the keyboard repeat-speed setting. More...

static xtd::drawing::size	max_window_track_size ()
	Gets the default maximum dimensions, in pixels, of a window that has a caption and sizing borders. More...

static bool	menu_access_keys_underlined ()
	Gets a value indicating whether menu access keys are always underlined. More...

static xtd::drawing::size	menu_bar_button_size ()
	Gets the default width, in pixels, for menu-bar buttons and the height, in pixels, of a menu bar. More...

static xtd::drawing::size	menu_button_size ()
	Gets the default dimensions, in pixels, of menu-bar buttons. More...

static xtd::drawing::size	menu_check_size ()
	Gets the dimensions, in pixels, of the default size of a menu check mark area. More...

static xtd::drawing::font	menu_font ()
	Gets the font used to display text on menus. More...

static int32_t	menu_height ()
	Gets the height, in pixels, of one line of a menu. More...

static int32_t	menu_show_delay ()
	Gets the time, in milliseconds, that the system waits before displaying a cascaded shortcut menu when the mouse cursor is over a submenu item. More...

static bool	mid_east_enabled ()
	Gets a value indicating whether the operating system is enabled for the Hebrew and Arabic languages. More...

static xtd::drawing::size	min_window_track_size ()
	Gets the default minimum dimensions, in pixels, that a window may occupy during a drag resize. More...

static xtd::drawing::size	minimized_window_size ()
	Gets the dimensions, in pixels, of a normal minimized window. More...

static xtd::drawing::size	minimized_window_spacing_size ()
	Gets the dimensions, in pixels, of the area each minimized window is allocated when arranged. More...

static xtd::drawing::size	minimum_window_size ()
	Gets the minimum width and height for a window, in pixels. More...

static int32_t	monitor_count ()
	Gets the number of display monitors on the desktop. More...

static bool	monitors_same_display_format ()
	Gets a value indicating whether all the display monitors are using the same pixel color format. More...

static int32_t	mouse_buttons ()
	Gets the number of buttons on the mouse. More...

static bool	mouse_buttons_swapped ()
	Gets a value indicating whether the functions of the left and right mouse buttons have been swapped. More...

static xtd::drawing::size	mouse_hover_size ()
	Gets the dimensions, in pixels, of the rectangle within which the mouse pointer has to stay for the mouse hover time before a mouse hover message is generated. More...

static int32_t	mouse_hover_time ()
	Gets the time, in milliseconds, that the mouse pointer has to stay in the hover rectangle before a mouse hover message is generated. More...

static bool	mouse_present ()
	Gets a value indicating whether the functions of the left and right mouse buttons have been swapped. More...

static int32_t	mouse_speed ()
	Gets the current mouse speed. More...

static bool	Mouse_wheel_present ()
	Gets a value indicating whether a mouse with a mouse wheel is installed. More...

static int32_t	mouse_wheel_scroll_delta ()
	Gets the amount of the delta value of a single mouse wheel rotation increment. More...

static int32_t	mouse_wheel_scroll_lines ()
	Gets the number of lines to scroll when the mouse wheel is rotated. More...

static bool	native_mouse_wheel_support ()
	Gets a value indicating whether a mouse with a mouse wheel is installed. More...

static bool	network ()
	Gets a value indicating whether a network connection is present. More...

static int32_t	vertical_scroll_bar_width ()

Member Function Documentation

◆ active_window_tracking_delay()

static int32_t xtd::forms::system_information::active_window_tracking_delay ( )

static

Gets the active window tracking delay.

Returns: The active window tracking delay, in milliseconds.

◆ arrange_direction()

static xtd::forms::arrange_direction xtd::forms::system_information::arrange_direction ( )

static

Gets a value that indicates the direction in which the operating system arranges minimized windows.

Returns: One of the ArrangeDirection values that indicates the direction in which the operating system arranges minimized windows.

Remarks: The arrange_direction property indicates the direction in which minimized windows are arranged on the desktop or in a Multiple Document Interface (MDI) container.

◆ arrange_starting_position()

static xtd::forms::arrange_starting_position xtd::forms::system_information::arrange_starting_position ( )

static

Gets an ArrangeStartingPosition value that indicates the starting position from which the operating system arranges minimized windows.

Returns: One of the ArrangeStartingPosition values that indicates the starting position from which the operating system arranges minimized windows.

Remarks: The ArrangeStartingPosition property indicates the corner of a screen or window in which the operating system begins to arrange minimized windows.

◆ boot_mode()

static xtd::forms::boot_mode xtd::forms::system_information::boot_mode ( )

static

Gets a BootMode value that indicates the boot mode the system was started in.

Returns: One of the boot_mode values that indicates the boot mode the system was started in.

Remarks: The boot_mode property indicates whether the operating system was started in a normal or safe boot mode.

◆ border_3d_size()

static xtd::drawing::size xtd::forms::system_information::border_3d_size ( )

static

Gets the thickness, in pixels, of a three-dimensional (3-D) style window or system control border.

Returns: A size that indicates the width, in pixels, of a 3-D style vertical border, and the height, in pixels, of a 3-D style horizontal border.

Remarks: The border_3d_size property indicates the thickness, in pixels, of a three-dimensional (3-D) style system control border.; The Width property of the border_3d_size property indicates the width of a vertical 3-D border. The Height property of the border_3d_size property indicates the height of a horizontal 3-D border.; The border_size property indicates the thickness of a window or system control border that is not a 3-D style border.

◆ border_multiplier_factor()

static int32_t xtd::forms::system_information::border_multiplier_factor ( )

static

Gets the border multiplier factor that is used when determining the thickness of a window's sizing border.

Returns: The multiplier used to determine the thickness of a window's sizing border.

◆ border_size()

static xtd::drawing::size xtd::forms::system_information::border_size ( )

static

Gets the thickness, in pixels, of a flat-style window or system control border.

Returns: A size that indicates the width, in pixels, of a vertical border, and the height, in pixels, of a horizontal border.

Remarks: The border_size property indicates the thickness of a flat-style system control border in pixels.; The Width property of the border_size property indicates the width of a vertical flat-style border. The Height property of the border_size property indicates the height of a horizontal flat-style border.; The border_3d_size property of the SystemInformation class indicates the thickness of a three-dimensional (3-D) style window or system control border.

◆ caption_button_size()

static xtd::drawing::size xtd::forms::system_information::caption_button_size ( )

static

Gets the standard size, in pixels, of a button in a window's title bar.

Returns: A size that indicates the standard dimensions, in pixels, of a button in a window's title bar.

Remarks: The caption_button_size property indicates the standard dimensions of a button in the title bar of a window.; The value of this property can be used to ensure that a button is properly sized to fit within the title bar of a window. Window caption buttons should be sized less than or equal to the standard dimensions for window caption buttons to ensure that they can be displayed in view correctly.

◆ caption_height()

static int32_t xtd::forms::system_information::caption_height ( )

static

Gets the height, in pixels, of the standard title bar area of a window.

Returns: The height, in pixels, of the standard title bar area of a window.

Remarks: The caption_height property indicates the height of the standard window title bar area, in pixels.

◆ caret_blink_time()

static int32_t xtd::forms::system_information::caret_blink_time ( )

static

Gets the caret blink time.

Returns: The caret blink time.

◆ caret_width()

static int32_t xtd::forms::system_information::caret_width ( )

static

Gets the width, in pixels, of the caret in edit controls.

Returns: The width, in pixels, of the caret in edit controls.

◆ computer_name()

static xtd::ustring xtd::forms::system_information::computer_name ( )

static

Gets the NetBIOS computer name of the local computer.

Returns: The name of this computer.

Remarks: The ComputerName property retrieves the NetBIOS name of the local computer. This is accomplished with a call into the native System Information function GetComputerName. This name is established at system startup_, when the system reads it from the registry. If the local computer is a node in a cluster, ComputerName returns the name of the cluster virtual server.; You can use the computer_name method to determine the name of the computer that is displayed to other users on a network.

◆ cursor_size()

static xtd::drawing::size xtd::forms::system_information::cursor_size ( )

static

Gets the maximum size, in pixels, that a cursor can occupy.

Returns: A size that indicates the maximum dimensions of a cursor in pixels.

Remarks: The system cannot create cursors of other sizes.

◆ dbcs_enabled()

static bool xtd::forms::system_information::dbcs_enabled ( )

static

Gets a value indicating whether the operating system is capable of handling double-byte character set (DBCS) characters.

Returns: true if the operating system supports DBCS; otherwise, false.

Remarks: The dbcs_enabled property indicates whether the current operating system supports DBCS.

◆ debug_os()

static bool xtd::forms::system_information::debug_os ( )

static

Gets a value indicating whether the debug version of USER.EXE is installed.

Returns: true if the debugging version of USER.EXE is installed; otherwise, false.

◆ double_click_size()

static xtd::drawing::size xtd::forms::system_information::double_click_size ( )

static

Gets the dimensions, in pixels, of the area within which the user must click twice for the operating system to consider the two clicks a double-click.

Returns: A size that indicates the dimensions, in pixels, of the area within which the user must click twice for the operating system to consider the two clicks a double-click.

Remarks: The double_click_size property indicates the size of a rectangular area centered around the point at which the last click occurred. To cause a double-click, a second click must occur within the area of the rectangle before the double-click time elapses.

◆ double_click_time()

static int32_t xtd::forms::system_information::double_click_time ( )

static

Gets the maximum number of milliseconds that can elapse between a first click and a second click for the OS to consider the mouse action a double-click.

Returns: The maximum amount of time, in milliseconds, that can elapse between a first click and a second click for the OS to consider the mouse action a double-click.

Remarks: A double-click is a series of two clicks of the mouse button, the second occurring within a specified length of time after, and within a specified distance from, the first. The double-click time is the maximum number of milliseconds that can elapse between the first and second click of a double-click.; The double_click_time property indicates the maximum number of milliseconds that can elapse before a second click for the second click to cause a double-click.

◆ drag_full_windows()

static bool xtd::forms::system_information::drag_full_windows ( )

static

Gets a value indicating whether the user has enabled full window drag.

Returns: true if the user has enabled full window drag; otherwise, false.

Remarks: When this property is true, the content of a window is refreshed during a window move or resize drag, using the current position and size as they are updated.

◆ drag_size()

static xtd::drawing::size xtd::forms::system_information::drag_size ( )

static

Gets the width and height of a rectangle centered on the point the mouse button was pressed, within which a drag operation will not begin.

Returns: A size that specifies the area of a rectangle, in pixels, centered on the point the mouse button was pressed, within which a drag operation will not begin.

Remarks: The drag_size property indicates the size, in pixels, of a rectangle centered around the point at which the mouse button was pressed. Windows uses the rectangle as a boundary within which it does not start a drag operation.; A user can hold a mouse button down and move the mouse within this area before a drag operation begins, which enables the user to click and release the mouse button easily without unintentionally starting a drag operation.

◆ fixed_frame_border_size()

static xtd::drawing::size xtd::forms::system_information::fixed_frame_border_size ( )

static

Gets the thickness, in pixels, of the frame border of a window that has a caption and is not resizable.

Returns: A size that specifies the thickness, in pixels, of a fixed sized window border.

Remarks: The fixed_frame_border_size property indicates the thickness of the frame, in pixels, around the perimeter of a window that has a caption but is not sizable.; The Width property of fixed_frame_border_size is the height of the horizontal border and the Height property of fixed_frame_border_size is the width of the vertical border.

◆ font_smoothing_contrast()

static int32_t xtd::forms::system_information::font_smoothing_contrast ( )

static

Gets the font smoothing contrast value used in ClearType smoothing.

Returns: The ClearType font smoothing contrast value.

◆ font_smoothing_type()

static int32_t xtd::forms::system_information::font_smoothing_type ( )

static

Gets the current type of font smoothing.

Returns: A value that indicates the current type of font smoothing.

◆ frame_border_size()

static xtd::drawing::size xtd::forms::system_information::frame_border_size ( )

static

Gets the thickness, in pixels, of the resizing border that is drawn around the perimeter of a window that is being drag resized.

Returns: A size that indicates the thickness, in pixels, of the width of a vertical resizing border and the height of a horizontal resizing border.

Remarks: The frame_border_size property indicates the width and height of the resizing border for a window.; The Width value of this property is the width of a vertical resizing border. The Height value of this property is the height of a horizontal resizing border.

◆ high_contrast()

static bool xtd::forms::system_information::high_contrast ( )

static

Gets a value indicating whether the user has enabled the high-contrast mode accessibility feature.

Returns: true if the user has enabled high-contrast mode; otherwise, false.

Remarks: The high-contrast accessibility feature can make the screen easier for some users to view by enabling a color scheme that can heighten screen contrast with alternative color combinations. Some of the schemes also change font sizes for easier reading.; The high-contrast mode feature can be enabled or disabled through the Accessibility Options control panel.

◆ horizontal_focus_thickness()

static int32_t xtd::forms::system_information::horizontal_focus_thickness ( )

static

Gets the thickness of the left and right edges of the system focus rectangle, in pixels.

Returns: The thickness of the left and right edges of the system focus rectangle, in pixels.

Remarks: The HorizontalFocusThickness property indicates the width of the left and right edges of the system focus rectangle, in pixels. The system focus rectangle is used to draw user's attention to a window or area by displaying a rectangular highlighted outline.

◆ horizontal_resize_border_thickness()

static int32_t xtd::forms::system_information::horizontal_resize_border_thickness ( )

static

Gets the thickness of the left and right edges of the sizing border around the perimeter of a window being resized, in pixels.

Returns: The width of the left and right edges of the sizing border around the perimeter of a window being resized, in pixels.

Remarks: The HorizontalResizeBorderThickness property indicates the width of the vertical sizing border around the perimeter of a window being resized.

◆ horizontal_scroll_bar_arrow_width()

static int32_t xtd::forms::system_information::horizontal_scroll_bar_arrow_width ( )

static

Gets the width, in pixels, of the arrow bitmap on the horizontal scroll bar.

Returns: The width, in pixels, of the arrow bitmap on the horizontal scroll bar.

◆ horizontal_scroll_bar_bhumb_width()

static int32_t xtd::forms::system_information::horizontal_scroll_bar_bhumb_width ( )

static

Gets the width, in pixels, of the scroll box in a horizontal scroll bar.

Returns: The width, in pixels, of the scroll box in a horizontal scroll bar.

◆ horizontal_scroll_bar_height()

static int32_t xtd::forms::system_information::horizontal_scroll_bar_height ( )

static

Gets the default height, in pixels, of the horizontal scroll bar.

Returns: The default height, in pixels, of the horizontal scroll bar.

◆ icon_horizontal_spacing()

static int32_t xtd::forms::system_information::icon_horizontal_spacing ( )

static

Gets the width, in pixels, of an icon arrangement cell in large icon view.

Returns: The width, in pixels, of an icon arrangement cell in large icon view.

Remarks: The IconHorizontalSpacing property indicates the width of the space for an icon in large icon view. The system uses this distance to arrange icons in large icon view.

◆ icon_size()

static xtd::drawing::size xtd::forms::system_information::icon_size ( )

static

Gets the dimensions, in pixels, of the Windows default program icon size.

Returns: A size that indicates the default dimensions, in pixels, for a program icon.

◆ icon_spacing_size()

static xtd::drawing::size xtd::forms::system_information::icon_spacing_size ( )

static

Gets the size, in pixels, of the grid square used to arrange icons in a large-icon view.

Returns: A size that specifies the dimensions, in pixels, of the grid square used to arrange icons in a large-icon view.

Remarks: The icon_spacing_size property indicates the size of the grid rectangle that each icon fits into when the system arranges them in a large-icon view. This value is always greater than or equal to icon_size.

◆ icon_vertical_spacing()

static int32_t xtd::forms::system_information::icon_vertical_spacing ( )

static

Gets the height, in pixels, of an icon arrangement cell in large icon view.

Returns: The height, in pixels, of an icon arrangement cell in large icon view.

Remarks: The icon_vertical_spacing property indicates the width of the space for an icon in large icon view. The system uses this distance to arrange icons in large icon view.

◆ is_active_window_tracking_enabled()

static bool xtd::forms::system_information::is_active_window_tracking_enabled ( )

static

Gets a value indicating whether active window tracking is enabled.

Returns: true if active window tracking is enabled; otherwise, false.

Remarks: The is_active_window_tracking_enabled property indicates whether active window tracking is enabled. Active window tracking causes any window the mouse is directly over to become the active window.

◆ is_combo_box_animation_enabled()

static bool xtd::forms::system_information::is_combo_box_animation_enabled ( )

static

Gets a value indicating whether the slide-open effect for combo boxes is enabled.

Returns: true if the slide-open effect for combo boxes is enabled; otherwise, false.

Remarks: The is_combo_box_animation_enabled property indicates whether the slide-open effect for system control combo boxes is enabled.; When the slide-open effect for system control combo boxes is enabled, the drop down menu of a combo box slides into view when it is displayed, instead of being immediately fully drawn in view.

◆ is_drop_shadow_enabled()

static bool xtd::forms::system_information::is_drop_shadow_enabled ( )

static

Gets a value indicating whether the drop shadow effect is enabled.

Returns: true if the drop shadow effect is enabled; otherwise, false.

◆ is_flat_menu_enabled()

static bool xtd::forms::system_information::is_flat_menu_enabled ( )

static

Gets a value indicating whether native user menus have a flat menu appearance.

Returns: true if native user menus have a flat menu appearance; otherwise, false.

◆ is_font_smoothing_enabled()

static bool xtd::forms::system_information::is_font_smoothing_enabled ( )

static

Gets a value indicating whether font smoothing is enabled.

Returns: bool true if the font smoothing feature is enabled; otherwise, false.

Remarks: This font smoothing feature uses font antialiasing to make font curves appear smoother by painting pixels at different gray levels.

◆ is_hot_tracking_enabled()

static bool xtd::forms::system_information::is_hot_tracking_enabled ( )

static

Gets a value indicating whether hot tracking of user-interface elements, such as menu names on menu bars, is enabled.

Returns: bool true if hot tracking of user-interface elements is enabled; otherwise, false.

Remarks: The IsHotTrackingEnabled property indicates whether hot tracking of user-interface elements is enabled. Hot tracking means that when the cursor moves over an item, it is highlighted but not selected.

◆ is_icon_title_wrapping_enabled()

static bool xtd::forms::system_information::is_icon_title_wrapping_enabled ( )

static

Gets a value indicating whether icon-title wrapping is enabled.

Returns: bool true if the icon-title wrapping feature is enabled; otherwise, false.

◆ is_keyboard_preferred()

static bool xtd::forms::system_information::is_keyboard_preferred ( )

static

Gets a value indicating whether the user relies on the keyboard instead of the mouse, and prefers applications to display keyboard interfaces that would otherwise be hidden.

Returns: bool true if keyboard preferred mode is enabled; otherwise, false.

Remarks: The IsKeyboardPreferred property indicates whether the user has indicated a preference for keyboard-based input interfaces.

◆ is_list_box_smooth_scrolling_enabled()

static bool xtd::forms::system_information::is_list_box_smooth_scrolling_enabled ( )

static

Gets a value indicating whether the smooth-scrolling effect for list boxes is enabled.

Returns: true if smooth-scrolling is enabled; otherwise, false.

Remarks: The is_list_box_smooth_scrolling_enabled property indicates whether the smooth-scrolling effect for system control list boxes is enabled.

◆ is_menu_animation_enabled()

static bool xtd::forms::system_information::is_menu_animation_enabled ( )

static

Gets a value indicating whether menu fade or slide animation features are enabled.

Returns: true if menu fade or slide animation is enabled; otherwise, false.

Remarks: The is_menu_animation_enabled property indicates whether either of the fade or slide animation features of system control menus is enabled.; If the value of this property is true, the IsMenuFadeEnabled property indicates whether menus use fade or slide animation.

◆ is_menu_fade_enabled()

static bool xtd::forms::system_information::is_menu_fade_enabled ( )

static

Gets a value indicating whether menu fade animation is enabled.

Returns: true if fade animation is enabled; false if it is disabled.

Remarks: The is_menu_fade_enabled property indicates whether a menu uses fade animation, if menu animation is enabled. The IsMenuAnimationEnabled property indicates whether menu animation is enabled.; If menu animation is enabled and the value of this property is true, menus use fade animation. If menu animation is enabled and the value of this property is false, menus use slide animation. If menu animation is disabled, the value of this property is meaningless.

◆ is_minimize_restore_animation_enabled()

static bool xtd::forms::system_information::is_minimize_restore_animation_enabled ( )

static

Gets a value indicating whether window minimize and restore animation is enabled.

Returns: true if window minimize and restore animation is enabled; otherwise, false.

Remarks: The is_minimize_restore_animation_enabled property indicates whether the window minimize and restore sequence is animated.

◆ is_selection_fade_enabled()

static bool xtd::forms::system_information::is_selection_fade_enabled ( )

static

Gets a value indicating whether the selection fade effect is enabled.

Returns: true if the selection fade effect is enabled; otherwise, false.

Remarks: The is_selection_fade_enabled property indicates whether the selection fade effect is enabled. The selection fade effect causes a menu item selected by the user to remain on the screen briefly while fading out after the menu is dismissed.

◆ is_snap_to_default_enabled()

static bool xtd::forms::system_information::is_snap_to_default_enabled ( )

static

Gets a value indicating whether the snap-to-default-button feature is enabled.

Returns: true if the snap-to-default-button feature is enabled; otherwise, false.

Remarks: The is_snap_to_default_enabled property indicates whether the snap-to-default-button feature is enabled. If the feature is enabled, the mouse cursor automatically moves to the default button, such as OK or Apply, of a dialog box.

◆ is_title_bar_gradient_enabled()

static bool xtd::forms::system_information::is_title_bar_gradient_enabled ( )

static

Gets a value indicating whether the gradient effect for window title bars is enabled.

Returns: true if the gradient effect for window title bars is enabled; otherwise, false.

Remarks: The is_title_bar_gradient_enabled property indicates whether the background of window title bars are drawn using a gradient fill effect.

Note: This property is supported only on Windows 98, Windows Millennium Edition, Windows 2000, Windows XP, and the Windows Server 2003 family.

◆ is_tool_tip_animation_enabled()

static bool xtd::forms::system_information::is_tool_tip_animation_enabled ( )

static

Gets a value indicating whether tool_tip animation is enabled.

Returns: true if tool_tip animation is enabled; otherwise, false.

Remarks: The is_tool_tip_animation_enabled property indicates whether tool_tips can fade or slide into view.

Note: This property is supported only on Windows 2000, Windows XP, and the Windows Server 2003 family. On other platforms, this property returns false.

◆ kanji_window_height()

static int32_t xtd::forms::system_information::kanji_window_height ( )

static

Gets the height, in pixels, of the Kanji window at the bottom of the screen for double-byte character set (DBCS) versions of Windows.

Returns: The height, in pixels, of the Kanji window.

Remarks: The kanji_window_height property indicates the height of the Kanji window on operating systems that support DBCS. The DbcsEnabled property indicates whether the operating system supports DBCS.

◆ keyboard_delay()

static int32_t xtd::forms::system_information::keyboard_delay ( )

static

Gets the keyboard repeat-delay setting.

Returns: The keyboard repeat-delay setting, from 0 (approximately 250 millisecond delay) through 3 (approximately 1 second delay).

Remarks: This property indicates the amount of time that elapses after a key is pressed and held down until keystroke repeat messages are sent by the operating system. This value is in the range from 0 (approximately 250 millisecond delay) through 3 (approximately 1 second delay). The actual delay associated with each value may vary depending on the hardware.; The keyboard_speed property indicates the repeat speed setting that determines the length of time between each keystroke repeat message sent by the operating system.

◆ keyboard_speed()

static int32_t xtd::forms::system_information::keyboard_speed ( )

static

Gets the keyboard repeat-speed setting.

Returns: The keyboard repeat-speed setting, from 0 (approximately 2.5 repetitions per second) through 31 (approximately 30 repetitions per second).

Remarks: This property indicates the time between each keystroke repeat message that is sent when a user presses and holds a key down. This is a value in the range from 0 (approximately 2.5 repetitions per second) through 31 (approximately 30 repetitions per second). The actual repeat rates are hardware-dependent and may vary from a linear scale by as much as 20%.; The keyboard_delay property indicates the length of time after a key is pressed and held down before keystroke repeat messages are sent by the operating system.

◆ max_window_track_size()

static xtd::drawing::size xtd::forms::system_information::max_window_track_size ( )

static

Gets the default maximum dimensions, in pixels, of a window that has a caption and sizing borders.

Returns: A size that specifies the maximum dimensions, in pixels, to which a window can be sized.

Remarks: The max_window_track_size property indicates the maximum dimensions to which a user can drag resize a window. The value returned by max_>window_track_size refers to the dimensions of the entire desktop.

◆ menu_access_keys_underlined()

static bool xtd::forms::system_information::menu_access_keys_underlined ( )

static

Gets a value indicating whether menu access keys are always underlined.

Returns: true if menu access keys are always underlined; false if they are underlined only when the menu is activated or receives focus.

Remarks: The menu_access_keys_underlined property indicates whether the menu shortcut keys are underlined in menu text even when the menu has not been activated or received focus.

◆ menu_bar_button_size()

static xtd::drawing::size xtd::forms::system_information::menu_bar_button_size ( )

static

Gets the default width, in pixels, for menu-bar buttons and the height, in pixels, of a menu bar.

Returns: A size that indicates the default width for menu-bar buttons, in pixels, and the height of a menu bar, in pixels.

Remarks: The size.width() value of this property indicates the default width for a button on a menu-bar, in pixels. The size.height() value of this property indicates the height of a menu bar, in pixels.

◆ menu_button_size()

static xtd::drawing::size xtd::forms::system_information::menu_button_size ( )

static

Gets the default dimensions, in pixels, of menu-bar buttons.

Returns: A size that indicates the default dimensions, in pixels, of menu-bar buttons.

Remarks: This property indicates the default dimensions, in pixels, for menu-bar buttons, such as the child window close button used in the multiple document interface.

◆ menu_check_size()

static xtd::drawing::size xtd::forms::system_information::menu_check_size ( )

static

Gets the dimensions, in pixels, of the default size of a menu check mark area.

Returns: A size that indicates the default size, in pixels, of a menu check mark area.

Remarks: The menu_check_size property indicates the size of the image used by Windows to display a check mark area next to a selected menu item.

◆ menu_font()

static xtd::drawing::font xtd::forms::system_information::menu_font ( )

static

Gets the font used to display text on menus.

Returns: The Font used to display text on menus.

Remarks: The menu_font property indicates the font used to display text on menus.

◆ menu_height()

static int32_t xtd::forms::system_information::menu_height ( )

static

Gets the height, in pixels, of one line of a menu.

Returns: The height, in pixels, of one line of a menu.

Remarks: The menu_height property indicates the height that is currently defined by Windows for a menu bar.

◆ menu_show_delay()

static int32_t xtd::forms::system_information::menu_show_delay ( )

static

Gets the time, in milliseconds, that the system waits before displaying a cascaded shortcut menu when the mouse cursor is over a submenu item.

Returns: The time, in milliseconds, that the system waits before displaying a cascaded shortcut menu when the mouse cursor is over a submenu item.

Remarks: The menu_show_delay property indicates the time, in milliseconds, that the system waits before displaying a cascaded shortcut menu when the mouse cursor is over a submenu item.

◆ mid_east_enabled()

static bool xtd::forms::system_information::mid_east_enabled ( )

static

Gets a value indicating whether the operating system is enabled for the Hebrew and Arabic languages.

Returns: true if the operating system is enabled for Hebrew or Arabic; otherwise, false.

Remarks: The mid_east_enabled property indicates whether the operating system is enabled for the Hebrew and Arabic languages.

◆ min_window_track_size()

static xtd::drawing::size xtd::forms::system_information::min_window_track_size ( )

static

Gets the default minimum dimensions, in pixels, that a window may occupy during a drag resize.

Returns: A size that indicates the default minimum width and height of a window during resize, in pixels.

Remarks: The min_window_track_size property indicates the default smallest window size that can be produced by using the borders to size the window.; The user cannot drag the window frame to a size smaller than these dimensions. A form can override these values by setting the minimum_size property.

◆ minimized_window_size()

static xtd::drawing::size xtd::forms::system_information::minimized_window_size ( )

static

Gets the dimensions, in pixels, of a normal minimized window.

Returns: A size that indicates the dimensions, in pixels, of a normal minimized window.

Remarks: The minimized_window_size property indicates the size of the area occupied by a normal minimized window.

◆ minimized_window_spacing_size()

static xtd::drawing::size xtd::forms::system_information::minimized_window_spacing_size ( )

static

Gets the dimensions, in pixels, of the area each minimized window is allocated when arranged.

Returns: A size that indicates the area each minimized window is allocated when arranged.

Remarks: The minimized_window_spacing_size property indicates the size, in pixels, of an arrangement grid cell for a minimized window. Each minimized window fits into a rectangle this size when arranged.; The value of this property is always greater than or equal to the value of the minimum_window_size property.

◆ minimum_window_size()

static xtd::drawing::size xtd::forms::system_information::minimum_window_size ( )

static

Gets the minimum width and height for a window, in pixels.

Returns: A size that specifies the minimum allowable dimensions of a window, in pixels.

Remarks: The minimum_window_size property indicates the dimensions specified by Windows as the minimum size for a window. You can use this property to limit the resizing of windows to dimensions not exceeding either dimension returned by this property.

Note: Developers of applications capable of resizing windows may want to use the value of this property to ensure that the application does not attempt to resize the window to a lesser width or height, since the dimensions of the window would be limited by the system.

◆ monitor_count()

static int32_t xtd::forms::system_information::monitor_count ( )

static

Gets the number of display monitors on the desktop.

Returns: The number of monitors that make up the desktop.

Remarks: The monitor_count property indicates the number of monitors currently recognized by the operating system. This property returns a value greater than one only if multiple monitors are currently recognized by the operating system.

Note: This property is supported only on Windows 98, Windows Millennium Edition, Windows 2000, Windows XP, and the Windows Server 2003 family.

◆ monitors_same_display_format()

static bool xtd::forms::system_information::monitors_same_display_format ( )

static

Gets a value indicating whether all the display monitors are using the same pixel color format.

Returns: true if all monitors are using the same pixel color format; otherwise, false.

Remarks: The monitors_same_display_format indicates whether all monitors currently recognized by the operating system are using the same pixel color format.; Pixel formats define the data structure used to encode pixel color and luminosity information. The pixel_format enumeration indicates a set of standard pixel color formats. Pixel values can be encoded in a variety of formats, with differing color value ranges and bit precisions, and differing positions of bits in a pixel data format structure.

Note: Two displays can have the same bit depth but different color formats.; This property is supported only on Windows 98, Windows Millennium Edition, Windows 2000, Windows XP, and the Windows Server 2003 family.

◆ mouse_buttons()

static int32_t xtd::forms::system_information::mouse_buttons ( )

static

Gets the number of buttons on the mouse.

Returns: The number of buttons on the mouse, or zero if no mouse is installed.

Remarks: The mouse_buttons property indicates the number of mouse buttons recognized on the currently installed mouse.; You can use mouse_buttons property to toggle additional functionality for users with more or less than the standard number of mouse buttons supported by your application.

◆ mouse_buttons_swapped()

static bool xtd::forms::system_information::mouse_buttons_swapped ( )

static

Gets a value indicating whether the functions of the left and right mouse buttons have been swapped.

Returns: true if the functions of the left and right mouse buttons are swapped; otherwise, false.

◆ mouse_hover_size()

static xtd::drawing::size xtd::forms::system_information::mouse_hover_size ( )

static

Gets the dimensions, in pixels, of the rectangle within which the mouse pointer has to stay for the mouse hover time before a mouse hover message is generated.

Returns: A size that indicates the dimensions, in pixels, of the rectangle within which the mouse pointer has to stay for the mouse hover time before a mouse hover message is generated.

Remarks: The mouse_hover_size property indicates the size of the rectangle within which the mouse pointer has to stay for the mouse hover time before a mouse hover message is generated.; The mouse_hover_time property indicates the time, in milliseconds, that a mouse pointer must remain within an area the size of the MouseHoverSize property in order to generate a mouse hover message.

◆ mouse_hover_time()

static int32_t xtd::forms::system_information::mouse_hover_time ( )

static

Gets the time, in milliseconds, that the mouse pointer has to stay in the hover rectangle before a mouse hover message is generated.

Returns: The time, in milliseconds, that the mouse pointer has to stay in the hover rectangle before a mouse hover message is generated.

Remarks: The mouse_hover_time property indicates the time, in milliseconds, that a mouse pointer must remain within an area the size of the MouseHoverSize property in order to generate a mouse hover message.; The mouse_hover_size property indicates the size of the rectangle within which the mouse pointer has to stay for the mouse hover time before a mouse hover message is generated.

◆ mouse_present()

static bool xtd::forms::system_information::mouse_present ( )

static

Gets a value indicating whether the functions of the left and right mouse buttons have been swapped.

Returns: true if a mouse is installed; otherwise, false.

Remarks: The mouse_present property indicates whether a pointing device is present or installed on the system. This is usually the case, so mouse_present almost always returns true.

◆ mouse_speed()

static int32_t xtd::forms::system_information::mouse_speed ( )

static

Gets the current mouse speed.

Returns: A mouse speed value between 1 (slowest) and 20 (fastest).

Remarks: The mouse speed determines how far the pointer will move based on the distance the mouse moves. The value of this property ranges between 1 (slowest) and 20 (fastest). A value of 10 is the default. The value can be set by an end user using the mouse control panel application or by an application using the SystemParametersInfo function of the Platform SDK.

◆ Mouse_wheel_present()

static bool xtd::forms::system_information::Mouse_wheel_present ( )

static

Gets a value indicating whether a mouse with a mouse wheel is installed.

Returns: true if a mouse with a mouse wheel is installed; otherwise, false.

Remarks: The Mouse_wheel_present property indicates whether the system recognizes a mouse wheel on an installed mouse.

Note: This property is equivalent to native_mouse_wheel_support.

◆ mouse_wheel_scroll_delta()

static int32_t xtd::forms::system_information::mouse_wheel_scroll_delta ( )

static

Gets the amount of the delta value of a single mouse wheel rotation increment.

Returns: The amount of the delta value of a single mouse wheel rotation increment.

Remarks: The delta value is an integer value that represents a single mouse wheel rotation increment. A downward mouse wheel rotation produces a negative delta value.

◆ mouse_wheel_scroll_lines()

static int32_t xtd::forms::system_information::mouse_wheel_scroll_lines ( )

static

Gets the number of lines to scroll when the mouse wheel is rotated.

Returns: The number of lines to scroll on a mouse wheel rotation, or -1 if the "One screen at a time" mouse option is selected.

Remarks: The mouse_wheel_scroll_lines property indicates how many lines to scroll, by default, in a multi-line control that has a scroll bar. The corresponding Platform SDK system-wide parameters are SPI_GETWHEELSCROLLLINES and SPI_SETWHEELSCROLLLINES. For more information about system-wide parameters, see "SystemParametersInfo" in the Platform SDK documentation at https://msdn.microsoft.com.

Note: Be sure to handle the special case that occurs if the "One screen at a time" mouse option is selected. In this case, the mouse_wheel_scroll_lines property has a value of -1.

◆ native_mouse_wheel_support()

static bool xtd::forms::system_information::native_mouse_wheel_support ( )

static

Gets a value indicating whether a mouse with a mouse wheel is installed.

Returns: true if a mouse with a mouse wheel is installed; otherwise, false.

Remarks: The native_mouse_wheel_support property indicates whether the system recognizes a mouse wheel on an installed mouse.

Note: This property is equivalent to mouse_wheel_present.

◆ network()

static bool xtd::forms::system_information::network ( )

static

Gets a value indicating whether a network connection is present.

Returns: true if a network connection is present; otherwise, false.

Remarks: The network property indicates whether the system has a currently established network connection.

Note: This property always returns true on all platforms.

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

xtd.forms/include/xtd/forms/system_information.h

Definition

Static Public Member Functions

Member Function Documentation

◆ active_window_tracking_delay()

◆ arrange_direction()

◆ arrange_starting_position()

◆ boot_mode()

◆ border_3d_size()

◆ border_multiplier_factor()

◆ border_size()

◆ caption_button_size()

◆ caption_height()

◆ caret_blink_time()

◆ caret_width()

◆ computer_name()

◆ cursor_size()

◆ dbcs_enabled()

◆ debug_os()

◆ double_click_size()

◆ double_click_time()

◆ drag_full_windows()

◆ drag_size()

◆ fixed_frame_border_size()

◆ font_smoothing_contrast()

◆ font_smoothing_type()

◆ frame_border_size()

◆ high_contrast()

◆ horizontal_focus_thickness()

◆ horizontal_resize_border_thickness()

◆ horizontal_scroll_bar_arrow_width()

◆ horizontal_scroll_bar_bhumb_width()

◆ horizontal_scroll_bar_height()

◆ icon_horizontal_spacing()

◆ icon_size()

◆ icon_spacing_size()

◆ icon_vertical_spacing()

◆ is_active_window_tracking_enabled()

◆ is_combo_box_animation_enabled()

◆ is_drop_shadow_enabled()

◆ is_flat_menu_enabled()

◆ is_font_smoothing_enabled()

◆ is_hot_tracking_enabled()

◆ is_icon_title_wrapping_enabled()

◆ is_keyboard_preferred()

◆ is_list_box_smooth_scrolling_enabled()

◆ is_menu_animation_enabled()

◆ is_menu_fade_enabled()

◆ is_minimize_restore_animation_enabled()

◆ is_selection_fade_enabled()

◆ is_snap_to_default_enabled()

◆ is_title_bar_gradient_enabled()

◆ is_tool_tip_animation_enabled()

◆ kanji_window_height()

◆ keyboard_delay()

◆ keyboard_speed()

◆ max_window_track_size()

◆ menu_access_keys_underlined()

◆ menu_bar_button_size()

◆ menu_button_size()

◆ menu_check_size()

◆ menu_font()

◆ menu_height()

◆ menu_show_delay()

◆ mid_east_enabled()

◆ min_window_track_size()

◆ minimized_window_size()

◆ minimized_window_spacing_size()

◆ minimum_window_size()

◆ monitor_count()

◆ monitors_same_display_format()

◆ mouse_buttons()

◆ mouse_buttons_swapped()

◆ mouse_hover_size()

◆ mouse_hover_time()

◆ mouse_present()

◆ mouse_speed()

◆ Mouse_wheel_present()

◆ mouse_wheel_scroll_delta()

◆ mouse_wheel_scroll_lines()

◆ native_mouse_wheel_support()