Loupe - Log - Monitor - Resolve
Gibraltar.Agent Namespace / Log Class / LiveViewerMessageFilter Event

In This Topic
    LiveViewerMessageFilter Event
    In This Topic
    Raised whenever the Loupe Live Viewer receives a new log message, allowing the client to block it from being included for display to users.
    Syntax
    'Declaration
     
    
    Public Event LiveViewerMessageFilter As Log.MessageFilterEventHandler
    public event Log.MessageFilterEventHandler LiveViewerMessageFilter
    Event Data

    The event handler receives an argument of type LogMessageFilterEventArgs containing data related to this event. The following LogMessageFilterEventArgs properties provide information specific to this event.

    PropertyDescription
    Cancel (block) this message from being displayed to users by the (LiveLogViewer) sender of this event.  
    A new log message received for possible display by the (LiveLogViewer) sender of this event.  
    Remarks

    Each LiveLogViewer instance filters independently with its own event. However, the main Loupe Live Viewer itself (accessible via hotkey unless disabled) is created within the Agent and its control object is not accessible to client code. This static event on the Log class therefore allows clients to bind to the filter on the main Loupe Live Viewer in order to filter the messages it displays to users (e.g. to block sensitive internal data).

    The Message property of the event args provides the log message in consideration, and the Cancel property allows the message to be displayed (false, the default) or blocked (true). The sender parameter of the event will be null to signify the main Loupe Live Viewer rather than a client-instantiated LiveLogViewer.

    Requirements

    Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

    See Also