![\"StatusBar\"](\"https:\/\/clarionsharp.com\/blog\/wp-content\/uploads\/2018\/01\/sb.png\")
<\/a><\/p>\nThe Status bar implementation exposes a set of 3 interfaces:<\/p>\n 1) IStatusZone: gives access to properties of a particular zone; 2) IStatusStyle: represents an instance of the style for the Status bar<\/p>\n 3) IStatusBar: represents an instance of the Status bar object<\/p>\n – Supported Properties: 2) PROP:StatusStyle – a SYSTEM property to get the reference to Both properties are read-only but the returned objects can be modified.<\/p>\n – When the Status bar object is created because of OPENing a – Because one instance of the status bar object can be shared by Window {PROP:Status, 1} = 0<\/p>\n – The initial state of the default status Style object mimics the traditional The rest of this post contains the details of the new interfaces.<\/p>\n Interfaces:<\/p>\n IStatusZone GetKind – Returns numeric value of zone’s type as they are GetWidth – If passed parameter is TRUE, function returns current SetWidth – Changes the unadjusted width of the zone. Rules are the If the value is negative, the zone is expandable with minimum HasBevel – Returns TRUE if a bevel is present around the content SetBevel – Modifies zone’s flag controlling the drawing of the – STATUSFLAG:OFF – to not draw the bevel Default value is STATUSFLAG:DEFAULT.<\/p>\n HasSeparator – Returns TRUE if separator is drawing at the far edge SetSeparator – Modifies zone’s flag controlling the drawing of the – STATUSFLAG:OFF – do not draw the separator If the last zone has the separator flag equal to STATUSFLAG:DEFAULT, the ——— GetText – Returns the current text of the zone. The returned value can be SetText – Changes the text displayed in the zone. Default value is GetAlignment – Returns the numeric value of text alignment as they are ! Alignment of text in text zones<\/p>\n SetAlignment – Changes the text alignment in the zone content area, GetIndent – Returns the value of text indentation in pixels relative to SetIndent – Changes text indent value to the passed value, countied in GetFont – Returns an instance of the IFontProperties interface SetFont – Changes the font used to draw text in the zone. *** Notes:<\/p>\n The IFontDescription interface has no public methods to clone and destroy ZoneFont &= BarStyle.GetFont() ! Get the font from style GetTextColor – Returns the color used to draw text in the zone. If the zone SetTextColor – Changes color of==used for drawing text. If the zone has its own FontChanged – This method must be called to notify the zone that its font has IImageZone GetImage – Returns the name of the image drawn in the zone. Returned SetImage – Sets\/changes the image displayed in the zone. Default value is *** Notes:<\/p>\n If the width of zone is greater than the width of the image, the image is drawn GetDrawMode – Returns the numeric value of the image drawing mode ! Modes of drawing images in image zones<\/p>\n StatusImageMode ITEMIZE(0),PRE(STATUSIMAGE) SetDrawMode – Changes the mode to draw zone image. Parameter must be ————- GetValue – Returns the current progress value.<\/p>\n SetValue – Changes the current progress value.<\/p>\n GetMin – Returns the lower bound for progress value.<\/p>\n GetMax – Returns the upper bound for progress value.<\/p>\n SetRange – Changes the lower and upper bounds for the progress value. GetColor – Returns the color used to draw the progress bar.<\/p>\n SetColor – Changes the color to draw the progress bar.<\/p>\n *** Notes:<\/p>\n If the progress zone has a bevel, the bevel is used as the frame for ———— Clone – Returns a cloned copy of the style object.<\/p>\n Destroy – Destroys the style object. The Destroy method must CreateBar – Creates the status bar object for the passed WINDOW Apply – Copies information from one style object to another. GetMetric – Returns the value for the given style metric. Parameter Supported metrics are: STATUS:ZONEHMARGIN – Horizontal margins around the zone content STATUS:ZONEVMARGIN – Vertical margins above and below the zone STATUS:TEXTHMARGIN – Horizontal margins around the STATUS:TEXTVMARGIN – Vertical margins above and below the text STATUS:TEXTINDENT – indentation of text relatively the STATUS:SEPMARGIN – margins above and below the zones’ ***Notes: All returned values are in pixels.<\/p>\n SetMetric – Changes the given style metric. The first parameter must GetHeight – Returns the height in pixels of the status bar determined SetHeight – Changes the unadjusted height for styled status bars. BkgndBrush – Returns the instance of the IBrush interface used to GetFont – Returns the instance of the IFontProperties interface SetFont – Sets\/changes the style’s default font. If the passed parameter is NULL GetTextColor – Returns the default color used to draw text in Text SetTextColor – Changes the default color used to draw text in Text GetProgressColor – Returns the default color used to draw Progress bars in SetProgressColor – Changes the color used to draw Progress bars in GetSeparatorColor – Returns the color used to draw flat separator lines.<\/p>\n SetSeparatorColor – Sets\/changes the color used to draw flat separator lines.<\/p>\n HasZoneBevel – Returns the default value of the flag to draw bevel around SetZoneBevel – Changes default value of the flag to draw the bevel around GetFlag – Returns value of the style flag corresponding to STATUS:THEMED – if TRUE, and themes are available for STATUS:SEPARATOR – if TRUE, the separator line is If the flag is FALSE (default), separators are not STATUS:GRIPPER – If TRUE, the resize gripper is drawn STATUS:BORDER3D – If TRUE, the status bar’s upper edge STATUS:SEPARATOR3D – If TRUE, separator lines are drawn SetFlag – Changes value of the style flag corresponding to passed ———- ApplyStyle – Applies parameters of the passed style to the status bar.<\/p>\n NumZones – Returns the number of zones in the status bar.<\/p>\n GetZone – Returns the reference to object implementing the zone AddZone – Creates the object implementing the zone of given kind DeleteZone – Destroys the number of zones equal to the second parameter *** Notes:<\/p>\n DeleteZone can be used to delete all zones from the status bar. This leaves Freeze – Freezes the status bar to avoid multiple redrawings on Unfreeze – Unfreezes previously frozen status bar. More than one SetClickCallback – Sets a callback function that is invoked if the mouse is clicked or The new implementation of the Status bar is fully backward compatible. This means that if a program doesn’t use any of the new Status bar\/style interfaces, the Status bar is drawn exactly the same as the old implementation. If the interfaces are used, besides the improved visual appearance there are the following changes: – An … Continue reading New Status bar implementation (C11)<\/span> <\/a><\/p>\n
\nthere are 3 extended interfaces derived from it for Text, Image
\nand Progress zones – ITextZone, IImageZone and IProgressZone<\/p>\n
\n1) PROP:StatusInterface – is used to get a reference to the
\nWINDOW’s Status bar object<\/p>\n
\nthe default status style object<\/p>\n
\nWINDOW with the STATUS attribute, or by setting the PROP:Status
\nproperty to a WINDOW without a Status bar, the current default style
\nis used to set up the bar’s appearance. The Status bar uses its own
\ncopy of the style data. Therefore changes in the default style do not
\naffect existing status bars automatically. The current bar’s
\nstyle can be changed by a call to the IStatusBar.ApplyStyle method.<\/p>\n
\nmore than one WINDOW, there is no method to destroy an instance of
\nthe IStatusBar interface. For backward compatibility, the
\nstatus bar of a WINDOW can be destroyed by specifying a zero width for
\nthe first zone using the PROP:Status property:<\/p>\n
\nStatus bar’s appearance. The only visual difference are the use of different RGB values
\nfor the colors used to draw the Status bar’s upper border and the zones bevels.<\/p>\n
\n———–<\/p>\n
\nlisted in the StatusZoneKind ITEMIZE structure<\/p>\nStatusZoneKind ITEMIZE(0),PRE(STATUSZONE)
\nTEXT EQUATE
\nIMAGE EQUATE
\nPROGRESS EQUATE
\nEND<\/code><\/p>\n
\nactual width of the zone in pixels including all
\nmargins, optional bevel and optional separator.
\nIf passed parameter is FALSE, function returns the
\nunadjusted width of zone in dialog units.<\/p>\n
\nsame as for value passed to the PROP:Status property.
\nUnadjusted width is given in zone’s dialog units
\nand does not include zone margins and the optional separator.<\/p>\n
\nwidth (in dlu’s) equal to the absolute value of the passed
\nnumber. By default, when A zone is created its
\nunadjusted width is set equal to -1. For text
\nzones dialog units are determined by the font used
\nto draw text in that zone. For zones of other kinds,
\ndialog units are determined by the font from the
\nStatus bar’s style.<\/p>\n
\npart of the zone, and FALSE if no bevel is present.<\/p>\n
\nbevel around content area. The passed parameter must be
\none of the values listed in the StatusFlagValue ITEMIZE
\nstructure:<\/p>\n
\n– STATUSFLAG:ON – to draw the bevel
\n– STATUSFLAG:DEFAULT – drawing of the bevel is
\ndetermined by status bar’s style.<\/p>\n
\nof the zone and FALSE if no separator is drawing<\/p>\n
\nseparator. Passed parameter must be one of values
\nlisted in the StatusFlagValue ITEMIZE structure:<\/p>\n
\n– STATUSFLAG:ON – draw the separator
\n– STATUSFLAG:DEFAULT – drawing of the separator is
\ndetermined by the Status bar’s style.
\nDefault value is STATUSFLAG:DEFAULT.<\/p>\n
\nseparator is not drawn regardless of the style settings.<\/p>\n
\nITextZone
\n———<\/p>\n
\npassed to the ToString function to convert it to a STRING type.<\/p>\n
\nan empty string.<\/p>\n
\nlisted in the StatusAlignValue ITEMIZE structure. The
\nSTATUSALIGN:DEFAULT and STATUSALIGN:LEFT values are
\nequivalent.<\/p>\nStatusAlignValue ITEMIZE(0),PRE(STATUSALIGN)
\nDEFAULT EQUATE
\nLEFT EQUATE
\nRIGHT EQUATE
\nCENTER EQUATE
\nEND<\/code><\/p>\n
\nDefault value is STATUSALIGN:DEFAULT<\/p>\n
\nthe base point determined by current alignment.<\/p>\n
\npixels. Default value is 0.<\/p>\n
\nallowing to modify parameters of the font used to
\ndraw text in the zone. A NULL result means that the zone is
\nusing the font specified by Status bar’s style.<\/p>\n
\nDefault value is NULL, i.e. usage of the font from the
\nStatus bar’s style.<\/p>\n
\ninstances. ITextZone.SetFont automatically releases the previous zone’s
\nfont (unless it is NULL), clones the passed font (unless it is NULL) and
\nset it to zone. The expected flow of work with a zone’s font is as
\nfollows:<\/p>\n
\nZone.SetFont (ZoneFont) ! Set the clone of font to zone
\nZoneFont &= Zone.GetFont() ! Get the reference to cloned font
\n… modify font …
\nZone.FontChanged() ! Notify zone that font changed<\/p>\n
\nhas its own font, the returned value is equal to
\nresult of call to IFontProperties.FontColor() for this
\nfont. If the zone is using the default font from the bar’s
\nstyle, the text color can be changed separately. In this
\ncase, GetTextColor() returns that color value.<\/p>\n
\nfont, this function has the same effect as a call to the
\nfont’s IFontProperties.FontColor(newcolor) method. If the
\nzone is using the default font from the bar’s style, this
\nfunction can be used to change text color in the zone
\nwhile retaining all other characteristics of the default
\nfont.<\/p>\n
\nbeen changed by calls to methods of the IFontProperties
\ninterface returned by the GetFont function.<\/p>\n
\n———-<\/p>\n
\nvalue can be passed to the ToString function to convert
\nit to STRING type.<\/p>\n
\nNULL which means that zone remains blank.<\/p>\n
\nleft aligned in the zone content rectangle (right-aligned in case of
\nright-to-left window layout). If width of the zone is less or equal to the width of
\nthe image, the image is drawn centered in the zone content rectangle.<\/p>\n
\nas they are listed in the StatusImageMode ITEMIZE
\nstructure.<\/p>\n
\nNORMAL EQUATE
\nDISABLED EQUATE
\nGRAYED EQUATE
\nEND<\/p>\n
\none of values listed in the StatusImageMode ITEMIZE
\nstructure. Default value is STATUSIMAGE:NORMAL.<\/p>\n
\nIProgressZone
\n————-<\/p>\n
\nDefault range is 0..100<\/p>\n
\nthe progress bar. If the zone has no bevel, additional lines are drawn to
\nshow the unfilled part of the progress bar.<\/p>\n
\nIStatusStyle
\n————<\/p>\n
\nbe called for all style objects returned from calls
\nto IStatusStyle.Clone methods.<\/p>\n
\nusing the style determining by SELF. The previous
\nWINDOW’s status bar object is disposed. It is not
\nrecommended to use this function for the active MDI
\nchild window. Created status bar has no zones and
\nis frozen.<\/p>\n
\nCan be used for “atomic” changing of the system
\ndefault status style.<\/p>\n
\nmust be one of values listed in the StatusMetric
\nITEMIZE structure.<\/p>\n
\nSTATUS:HMARGIN – margin from status bar edge to first
\nzone and, if no resize gripper is drawn, from
\nthe last zone to the status bar edge. Default value
\nis 4.<\/p>\n
\nrectangle. Default value is 4.<\/p>\n
\ncontent rectangle. Default value is 2.<\/p>\n
\ntext bounding rectangle in text zones. Default
\nvalue is 2.<\/p>\n
\nbounding rectangle in text zones. Default value
\nis 0.<\/p>\n
\nbase point (determined by text alignment) in the
\ntext bounding rectangle. Default value is 0.<\/p>\n
\nseparator line. Default value is 2.<\/p>\n
\nbe one of values listed in the StatusMetric ITEMIZE
\nstructure.<\/p>\n
\nby the style. If the parameter value is FALSE, the function
\nreturns the value set by last call to the SetHeight method.
\nIf parameter is TRUE, function returns adjusted height
\nvalue. Adjusted height is maximum of GetHeight(FALSE)
\nand height calculated from style’s font and metrics.<\/p>\n
\nPassed value must be in pixels. Default value is 0,
\ni.e. the adjusted height is determined by the font and
\nmetrics.<\/p>\n
\ndraw the Status bar’s background. If IBrush.Type is
\nCWBrush_Null (default), the background is painted
\nusing the COLOR:BTNFACE color.<\/p>\n
\nused as the default font for Text zones.<\/p>\n
\n(default), the font specified by SYSTEM properties is used.<\/p>\n
\nzones.<\/p>\n
\nzones. If the passed value is COLOR:None, the color returned
\nby SYSTEM{PROP:FontColor + PROP:StatusFont} is used.<\/p>\n
\nprogress zones.<\/p>\n
\nprogress zones.<\/p>\n
\nthe content rectangle for zones of a given kind.<\/p>\n
\ncontent rectangle for zones of the kind given by the first
\nparameter. Default value is TRUE for text zones and
\nFALSE for image and progress zones.<\/p>\n
\npassed parameter. Parameter must be one of values
\nlisted in the StausStyleFlag ITEMIZE structure:<\/p>\n
\nthe program, some metrics and visual aspects are
\ndetermined by the visual theme rather than by values
\nset in the style. If the flag is FALSE, style does not
\nuse the visual theme.<\/p>\n
\ndrawn after every zone except the last one by default.<\/p>\n
\ndrawn unless this setting is overridden in a
\nparticular zone.<\/p>\n
\nin the lower-far corner of status bars owned by resizable
\nnot-maximized WINDOWs. If flag is FALSE (default),
\nthe gripper is not drawn.<\/p>\n
\nis drawn using a bevel. If the flag is FALSE, a flat
\nborder is drawn. The flag only affects not-themed
\nstatus bars using solid colors to paint the bar’s
\nbackground. The flat border is drawn in all other
\ncases.<\/p>\n
\nusing a bevel. If the flag is FALSE, the separator line
\nis drawn flat. Flag is ignored for themed status
\nbars.<\/p>\n
\nfirst parameter. This parameter must have one of values
\nlisted in the StatusStyleFlag ITEMIZE structure.<\/p>\n
\nIStatusBar
\n———-<\/p>\n
\nwith passed index. Index value is 1-based. If passed
\nindex is 0 or greater than number of zones, a NULL
\nreference is returned.<\/p>\n
\nand inserts it at position specified by first parameter.
\nIf position parameter is out of range 1..,
\nthe created zone is appending to the end of list of zones.
\nThe position value is 1-based.<\/p>\n
\nstarting from the position given by the first parameter. By default,
\nthe only zone is creating. If second parameter is 0,
\nall zones since passed position are destroyed.<\/p>\n
\nan empty status bar.<\/p>\n
\nvolume changes to zones.<\/p>\n
\nlevel of freezing is possible, therefore the number of calls
\nto Unfreeze must be equal to number of calls
\nto Freeze.<\/p>\n
\ndouble clicked within content rectangle of any zone. The
\n1-based index of clicked zone is passed to the callback
\nfunction as a parameter. The KEYCODE() function can be used
\nto determine which mouse button has been clicked.<\/p>\n","protected":false},"excerpt":{"rendered":"