indexing description: "Toolbar style (TB_STYLE...) constants." legal: "See notice at end of class." status: "See notice at end of class." date: "$Date: 2006-02-27 21:05:08 -0800 (Mon, 27 Feb 2006) $" revision: "$Revision: 57197 $" class interface WEL_TB_STYLE_CONSTANTS create default_create -- Process instances of classes with no creation clause. -- (Default: do nothing.) -- (from ANY) feature -- Access generating_type: STRING_8 -- Name of current object's generating type -- (type of which it is a direct instance) -- (from ANY) generator: STRING_8 -- Name of current object's generating class -- (base class of the type of which it is a direct instance) -- (from ANY) feature -- Access -- A toolbar can have a combination of the following styles. tbstyle_altdrag: INTEGER_32 is 1024 -- Allows the user to change the position of a toolbar -- button by dragging it while holding down the ALT key. -- If this style is not specified, the user must hold -- down the SHIFT key while dragging a button. Note -- that the Ccs_adjustable style must be specified to -- enable toolbar buttons to be dragged. tbstyle_autosize: INTEGER_32 is 16 -- The toolbar will not assign the standard width to -- the button. Instead, the buttons width will be calculated -- based on the width of the text plus the image of the -- button. tbstyle_button: INTEGER_32 is 0 -- Creates a standard push button. tbstyle_check: INTEGER_32 is 2 -- Creates a button that toggles between the pressed -- and not pressed states each time the user clicks it. -- The button has a different background color when it -- is in the pressed state. tbstyle_checkgroup: INTEGER_32 is 6 -- Creates a check button that stays pressed until -- another button in the group is pressed. tbstyle_customerase: INTEGER_32 is 8192 -- Generates NM_CUSTOMDRAW notification messages when -- it processes WM_ERASEBKGND. tbstyle_dropdown: INTEGER_32 is 8 -- Creates a drop-down list button. If the toolbar has -- the TBSTYLE_EX_DRAWDDARROWS extended style, an arrow -- will be displayed next to the button. tbstyle_flat: INTEGER_32 is 2048 -- Creates a transparent toolbar with flat buttons. -- The apparence of the button change when the user -- move the mouse on the button. tbstyle_group: INTEGER_32 is 4 -- Creates a button that stays pressed until another -- button in the group is pressed. tbstyle_list: INTEGER_32 is 4096 -- Places button text to the right of button bitmaps. -- To avoid repainting problems, this style should be -- set before the toolbar control becomes visible. tbstyle_sep: INTEGER_32 is 1 -- Creates a separator, providing a small gap between -- button groups. A button that has this style does not -- receive user input. tbstyle_tooltips: INTEGER_32 is 256 -- Creates a tooltip control that an application can -- use to display descriptive text for the buttons in -- the toolbar. tbstyle_transparent: INTEGER_32 is 32768 -- Version 4.71. Creates a transparent toolbar. In a transparent toolbar, -- the toolbar is transparent but the buttons are not. Button text appears -- under button bitmaps. To prevent repainting problems, this style should -- be set before the toolbar control becomes visible. -- A button in a toolbar can have a combination of the following styles. tbstyle_wrapable: INTEGER_32 is 512 -- Creates a toolbar that can have multiple lines of -- buttons. Toolbar buttons can "wrap" to the next -- line when the toolbar becomes too narrow to include -- all buttons on the same line. Wrapping occurs on -- separation and non-group boundaries. feature -- Comparison frozen deep_equal (some: ANY; other: like arg #1): BOOLEAN -- Are `some' and `other' either both void -- or attached to isomorphic object structures? -- (from ANY) ensure -- from ANY shallow_implies_deep: standard_equal (some, other) implies Result both_or_none_void: (some = Void) implies (Result = (other = Void)) same_type: (Result and (some /= Void)) implies some.same_type (other) symmetric: Result implies deep_equal (other, some) frozen equal (some: ANY; other: like arg #1): BOOLEAN -- Are `some' and `other' either both void or attached -- to objects considered equal? -- (from ANY) ensure -- from ANY definition: Result = (some = Void and other = Void) or else ((some /= Void and other /= Void) and then some.is_equal (other)) is_equal (other: like Current): BOOLEAN -- Is `other' attached to an object considered -- equal to current object? -- (from ANY) require -- from ANY other_not_void: other /= Void ensure -- from ANY symmetric: Result implies other.is_equal (Current) consistent: standard_is_equal (other) implies Result frozen standard_equal (some: ANY; other: like arg #1): BOOLEAN -- Are `some' and `other' either both void or attached to -- field-by-field identical objects of the same type? -- Always uses default object comparison criterion. -- (from ANY) ensure -- from ANY definition: Result = (some = Void and other = Void) or else ((some /= Void and other /= Void) and then some.standard_is_equal (other)) frozen standard_is_equal (other: like Current): BOOLEAN -- Is `other' attached to an object of the same type -- as current object, and field-by-field identical to it? -- (from ANY) require -- from ANY other_not_void: other /= Void ensure -- from ANY same_type: Result implies same_type (other) symmetric: Result implies other.standard_is_equal (Current) feature -- Status report conforms_to (other: ANY): BOOLEAN -- Does type of current object conform to type -- of `other' (as per Eiffel: The Language, chapter 13)? -- (from ANY) require -- from ANY other_not_void: other /= Void same_type (other: ANY): BOOLEAN -- Is type of current object identical to type of `other'? -- (from ANY) require -- from ANY other_not_void: other /= Void ensure -- from ANY definition: Result = (conforms_to (other) and other.conforms_to (Current)) feature -- Duplication copy (other: like Current) -- Update current object using fields of object attached -- to `other', so as to yield equal objects. -- (from ANY) require -- from ANY other_not_void: other /= Void type_identity: same_type (other) ensure -- from ANY is_equal: is_equal (other) frozen deep_copy (other: like Current) -- Effect equivalent to that of: -- copy (`other' . deep_twin) -- (from ANY) require -- from ANY other_not_void: other /= Void ensure -- from ANY deep_equal: deep_equal (Current, other) frozen deep_twin: like Current -- New object structure recursively duplicated from Current. -- (from ANY) ensure -- from ANY deep_equal: deep_equal (Current, Result) frozen standard_copy (other: like Current) -- Copy every field of `other' onto corresponding field -- of current object. -- (from ANY) require -- from ANY other_not_void: other /= Void type_identity: same_type (other) ensure -- from ANY is_standard_equal: standard_is_equal (other) frozen standard_twin: like Current -- New object field-by-field identical to `other'. -- Always uses default copying semantics. -- (from ANY) ensure -- from ANY standard_twin_not_void: Result /= Void equal: standard_equal (Result, Current) frozen twin: like Current -- New object equal to `Current' -- twin calls copy; to change copying/twining semantics, redefine copy. -- (from ANY) ensure -- from ANY twin_not_void: Result /= Void is_equal: Result.is_equal (Current) feature -- Basic operations frozen default: like Current -- Default value of object's type -- (from ANY) frozen default_pointer: POINTER -- Default value of type `POINTER' -- (Avoid the need to write `p'.default for -- some `p' of type `POINTER'.) -- (from ANY) default_rescue -- Process exception for routines with no Rescue clause. -- (Default: do nothing.) -- (from ANY) frozen do_nothing -- Execute a null action. -- (from ANY) feature -- Output io: STD_FILES -- Handle to standard file setup -- (from ANY) out: STRING_8 -- New string containing terse printable representation -- of current object -- Was declared in ANY as synonym of tagged_out. -- (from ANY) print (some: ANY) -- Write terse external representation of `some' -- on standard output. -- (from ANY) frozen tagged_out: STRING_8 -- New string containing terse printable representation -- of current object -- Was declared in ANY as synonym of out. -- (from ANY) feature -- Platform operating_environment: OPERATING_ENVIRONMENT -- Objects available from the operating system -- (from ANY) feature -- Tool bar button styles btns_autosize: INTEGER_32 is 16 -- Version 5.80. Specifies that the toolbar control should -- not assign the standard width to the button. Instead, -- the button's width will be calculated based on the width -- of the text plus the image of the button. -- Use the equivalent style flag, TBSTYLE_AUTOSIZE, for -- version 4.72 and earlier. btns_dropdown: INTEGER_32 is 8 -- Version 5.80. Creates a drop-down style button that -- can display a list when the button is clicked. Instead -- of the WM_COMMAND message used for normal buttons, -- drop-down buttons send a TBN_DROPDOWN notification. -- An application can then have the notification handler -- display a list of options. Use the equivalent style -- flag, TBSTYLE_DROPDOWN, for version 4.72 and earlier. -- If the toolbar has the TBSTYLE_EX_DRAWDDARROWS extended -- style, drop-down buttons will have a drop-down arrow -- displayed in a separate section to their right. If the -- arrow is clicked, a TBN_DROPDOWN notification will be -- sent. If the associated button is clicked, a WM_COMMAND -- message will be sent. btns_showtext: INTEGER_32 is 64 -- Version 5.81. Specifies that button text should be -- displayed. All buttons can have text, but only those -- buttons with the BTNS_SHOWTEXT button style will -- display it. This button style must be used with the -- TBSTYLE_LIST style and the TBSTYLE_EX_MIXEDBUTTONS -- extended style. If you set text for buttons that do -- not have the BTNS_SHOWTEXT style, the toolbar control -- will automatically display it as a ToolTip when the -- cursor hovers over the button. This feature allows your -- application to avoid handling the TBN_GETINFOTIP -- notification for the toolbar. feature -- Tool bar extended styles tbstyle_ex_doublebuffer: INTEGER_32 is 128 -- Version 6. This style requires the toolbar to be double -- buffered. Double buffering is a mechanism that detects when -- the toolbar has changed. -- Note Comctl32.dll version 6 is not redistributable but it -- is included in Microsoft Windows XP or later. To use -- Comctl32.dll version 6, specify it in a manifest. For more -- information on manifests, see Using Windows XP Visual Styles. tbstyle_ex_drawddarrows: INTEGER_32 is 1 -- Version 4.71. This style allows buttons to have a separate -- dropdown arrow. Buttons that have the BTNS_DROPDOWN style -- will be drawn with a drop-down arrow in a separate section, -- to the right of the button. If the arrow is clicked, only -- the arrow portion of the button will depress, and the toolbar -- control will send a TBN_DROPDOWN notification to prompt the -- application to display the dropdown menu. If the main part -- of the button is clicked, the toolbar control sends a -- WM_COMMAND message with the button's ID. The application -- normally responds by launching the first command on the menu. -- There are many situations where you may want to have only -- some of the dropdown buttons on a toolbar with separated. -- To do so, set the TBSTYLE_EX_DRAWDDARROWS extended style. -- Give those buttons that will not have separated arrows the -- BTNS_WHOLEDROPDOWN style. Buttons with this style will have -- an arrow displayed next to the image. However, the arrow will -- not be separate and when any part of the button is clicked, -- the toolbar control will send a TBN_DROPDOWN notification. -- To prevent repainting problems, this style should be set -- before the toolbar control becomes visible. tbstyle_ex_hideclippedbuttons: INTEGER_32 is 16 -- Version 5.81. This style hides partially clipped buttons. -- The most common use of this style is for toolbars that are -- part of a rebar control. If an adjacent band covers part of -- a button, the button will not be displayed. However, if the -- rebar band has the RBBS_USECHEVRON style, the button will be -- displayed on the chevron's dropdown menu. tbstyle_ex_mixedbuttons: INTEGER_32 is 8 -- Version 5.81. This style allows you to set text for all -- buttons, but only display it for those buttons with the -- BTNS_SHOWTEXT button style. The TBSTYLE_LIST style must also -- be set. Normally, when a button does not display text, your -- application must handle TBN_GETINFOTIP to display a ToolTip. -- With the TBSTYLE_EX_MIXEDBUTTONS extended style, text that -- is set but not displayed on a button will automatically be -- used as the button's ToolTip text. Your application only -- needs to handle TBN_GETINFOTIP if it needs more flexibility -- in specifying the ToolTip text. invariant -- from ANY reflexive_equality: standard_is_equal (Current) reflexive_conformance: conforms_to (Current) indexing copyright: "Copyright (c) 1984-2006, Eiffel Software and others" license: "Eiffel Forum License v2 (see http://www.eiffel.com/licensing/forum.txt)" source: "[ Eiffel Software 356 Storke Road, Goleta, CA 93117 USA Telephone 805-685-1006, Fax 805-685-6869 Website http://www.eiffel.com Customer support http://support.eiffel.com ]" end -- class WEL_TB_STYLE_CONSTANTS