{
* Hiliter.UGlobals.pas
*
* Declares various types that describe syntax hilighters and and defines
* interfaces to various syntax highlighters and highlighter attributes.
*
* $Rev$
* $Date$
*
* ***** BEGIN LICENSE BLOCK *****
*
* Version: MPL 1.1
*
* The contents of this file are subject to the Mozilla Public License Version
* 1.1 (the "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at http://www.mozilla.org/MPL/
*
* Software distributed under the License is distributed on an "AS IS" basis,
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for
* the specific language governing rights and limitations under the License.
*
* The Original Code is Hiliter.UGlobals.pas, formerly IntfHiliter.pas
*
* The Initial Developer of the Original Code is Peter Johnson
* (http://www.delphidabbler.com/).
*
* Portions created by the Initial Developer are Copyright (C) 2005-2011 Peter
* Johnson. All Rights Reserved.
*
* Contributor(s)
* NONE
*
* ***** END LICENSE BLOCK *****
}
unit Hiliter.UGlobals;
interface
uses
// Delphi
Classes, Graphics,
// Project
UEncodings;
type
/// <summary>Enumeration defining the different elements that can be
/// highlighted in Pascal source code.</summary>
THiliteElement = (
heWhitespace, // white space
heComment, // comments: in (* .. *), { .. } or // styles
heReserved, // reserved word (keyword or directives)
heIdentifier, // an identifier that is not "reserved"
heSymbol, // punctuation symbol or symbol group
heString, // string or character literal preceeded by #
heNumber, // whole number
heFloat, // floating point number (may be in scientific format)
heHex, // hexadecimal integer
hePreProcessor, // compiler directive: {$..} and (*$..*) styles supported
heAssembler, // assembler code between asm ... end keywords
heError // an unrecognised piece of code (shouldn't happen)
);
type
/// <summary>
/// Interface supported by objects that store style attributes applicable
/// to various source code elements used in syntax highlighting.
/// </summary>
IHiliteElemAttrs = interface(IInterface)
['{297A2F3D-77A8-45F9-A147-22A53791F114}']
/// <summary>Checks whether an element's attributes are "null" - i.e. all
/// properties have default values.</summary>
/// <remarks>Use to determine whether to output formatting information for
/// an element or not.</remarks>
function IsNul: Boolean;
/// <summary>Returns the font style to use for a source code element.
/// </summary>
function GetFontStyle: TFontStyles;
/// <summary>Sets the font style to use for a source code element.
/// </summary>
/// <param name="AFontStyle">TFontStyles [in] Required font style.</param>
procedure SetFontStyle(const AFontStyle: TFontStyles);
/// <summary>Returns the foreground (i.e. text) colour to use for a source
/// code element.</summary>
function GetForeColor: TColor;
/// <summary>Sets the foreground (i.e. text) colour to use for a source
/// code element.</summary>
/// <param name="AColor">TColor [in] Required colour.</param>
procedure SetForeColor(const AColor: TColor);
/// <summary>Set of font styles to use for a source code element.</summary>
property FontStyle: TFontStyles read GetFontStyle write SetFontStyle;
/// <summary>Foreground (i.e. Text) colour to use for a source code
/// element.</summary>
property ForeColor: TColor read GetForeColor write SetForeColor;
end;
type
/// <summary>
/// Interface implemented by objects that store style attributes that are
/// used in a syntax highlighter.
/// </summary>
IHiliteAttrs = interface(IInterface)
['{25570AEE-3225-42A7-A534-3D27357EEA2E}']
/// <summary>Returns name of font to use for all source code.</summary>
function GetFontName: string;
/// <summary>Sets name of font to use for all source code.</summary>
/// <param name="AFontName">string [in] Name of required font.</param>
procedure SetFontName(const AFontName: string);
/// <summary>Returns size of font to use for all source code.</summary>
/// <remarks>Font size is in points.</remarks>
function GetFontSize: Integer;
/// <summary>Sets size of font to use for all source code.</summary>
/// <param name="AFontSize">Integer [in] Required font size in points.
/// </param>
procedure SetFontSize(const AFontSize: Integer);
/// <summary>Resets name and size of font used for all source code to
/// default value.</summary>
procedure ResetDefaultFont;
/// <summary>Returns style attributes for a source code element.</summary>
/// <param name="Elem">THiliteElement [in] Specifies required attribute.
/// </param>
/// <returns>IHiliteElemAttrs [in] Interface to object providing required
/// style attributes.</returns>
function GetElement(const Elem: THiliteElement): IHiliteElemAttrs;
/// <summary>Name of font used for all source code.</summary>
property FontName: string read GetFontName write SetFontName;
/// <summary>Size of font used for all soure code.</summary>
property FontSize: Integer read GetFontSize write SetFontSize;
/// <summary>List of style attributes for each source code element.
/// </summary>
property Elements[const Elem: THiliteElement]: IHiliteElemAttrs
read GetElement; default;
end;
type
/// <summary>Enumeration of identifiers for the various predefined
/// highlighter styles.</summary>
TPredefinedHiliteStyle = (
hsNul, // nul highlighter style
hsCodeSnip, // original codesnip default style
hsDelphi7, // Delphi 7 default style
hsDelphi2006, // Delphi 2006 default style
hsVisualStudio // Microsoft Visual Studio default style
);
type
/// <summary>Interface implemented by objects that format different source
/// code elements on behalf of syntax highlighter.</summary>
/// <remarks>Implement this interface for each required output format.
/// Syntax highlighter calls the methods of this interface.</remarks>
IHiliteRenderer = interface(IInterface)
['{791CE200-C614-40FC-B93D-744ED2984755}']
/// <summary>Called by syntax highlighter before any source code is
/// processed.</summary>
procedure Initialise;
/// <summary>Called by syntax highlighter after all source code has been
/// processed.</summary>
procedure Finalise;
/// <summary>Called by syntax highlighter when a new line of source code
/// is started.</summary>
procedure BeginLine;
/// <summary>Called by syntax highlighter after a line of souce code is
/// complete.</summary>
procedure EndLine;
/// <summary>Called by syntax highlighter just before a source code
/// element is to be output.</summary>
/// <param name="Elem">THiliteElement [in] Type of element to be output.
/// </param>
procedure BeforeElem(Elem: THiliteElement);
/// <summary>Called by syntax highlighter for each element of source code
/// read. All the given text should be formatted in same style.</summary>
/// <remarks>Type of the element will have been specified in prior call to
/// BeforeElem.</remarks>
procedure WriteElemText(const Text: string);
/// <summary>Called by syntax highlighter just after an element of source
/// code has been written.</summary>
/// <param name="Elem">THiliteElement [in] Type of element that has just
/// been output.</param>
procedure AfterElem(Elem: THiliteElement);
end;
implementation
end.
