Control PenPicker/BrushPicker/SymbolPicker/FontPicker clause - MapBasic - 2023

Purpose

Part of a Dialog statement; adds a button showing a pen (line), brush (fill), symbol (point), or font (text) style.

Syntax

Control { PenPicker | BrushPicker | SymbolPicker | FontPicker } 
	[ Position x, y ] [ Width w ] [ Height h ] 
	[ ID control_ID ] 
	[ Calling handler ] 
	[ Value style_expr ] 
	[ Into style_var ] 
	[ Disable ] [ Hide ] 

x, y specifies the control's position, in dialog box units.

w specifies the control's width, in dialog box units; default width is 20.

h specifies the control's height, in dialog box units; default height is 20.

control_ID is an integer; cannot be the same as the ID of another control in the dialog box.

handler is the name of a handler procedure; if the user clicks on the Picker control, and then clicks OK on the style dialog box which appears, MapBasic calls the handler procedure.

style_expr is a Pen, Brush, Symbol, or Font expression, specifying what style will appear initially in the control; this expression type must match the type of control (for example, must be a Pen expression if the control is a PenPicker).

style_var is the name of a Pen, Brush, Symbol, or Font variable; this variable type must match the type of control (for example, must be a Pen variable if the control is a PenPicker control).

The Disable keyword makes the control disabled (grayed out) initially.

The Hide keyword makes the control hidden initially.

Description

A Picker control (PenPicker, BrushPicker, SymbolPicker, or FontPicker) is a button showing a pen, brush, symbol, or font style. If the user clicks on the button, a dialog box appears to allow the user to change the style.

Example

Control SymbolPicker 
	Position 140,42 
	Into sym_storemarker

See Also:

Alter Control statement, Dialog statement, ReadControlValue() function