office-gobmx/include/sfx2/lokcallback.hxx
Michael Meeks a71a5cdb97 lok: add dumpState feature for better in-field diagnostics.
Always suspicious that some un-expected dialog / state can cause
strange behavior in a client. An initial cut at an API to make it
easier to unwind such problems by exposing the toolkit state.

Change-Id: If8f17943fa4837df4f9ca659a111dcdce5c23244
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/137504
Tested-by: Jenkins
Reviewed-by: Michael Meeks <michael.meeks@collabora.com>
2022-07-28 14:49:19 +02:00

56 lines
2.3 KiB
C++

/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
/*
* This file is part of the LibreOffice project.
*
* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
*/
#pragma once
#include <sal/types.h>
namespace rtl
{
class OStringBuffer;
}
namespace tools
{
class Rectangle;
}
// An extended callback type that allows passing in also some binary data,
// so that post-processing the messages does not require conversions
// from and to strings.
// TODO: It might possibly make sense to drop the generic type/payload function
// and have only a dedicated function for each message type?
class SAL_NO_VTABLE SAL_DLLPUBLIC_RTTI SfxLokCallbackInterface
{
public:
virtual ~SfxLokCallbackInterface() {}
// LibreOfficeKitCallback equivalent.
virtual void libreOfficeKitViewCallback(int nType, const char* pPayload) = 0;
// Callback that explicitly provides view id (which is also included in the payload).
virtual void libreOfficeKitViewCallbackWithViewId(int nType, const char* pPayload, int nViewId)
= 0;
// LOK_CALLBACK_INVALIDATE_TILES
// nPart is either part, -1 for all-parts, or INT_MIN if
// comphelper::LibreOfficeKit::isPartInInvalidation() is not set
virtual void libreOfficeKitViewInvalidateTilesCallback(const tools::Rectangle* pRect, int nPart)
= 0;
// A message of the given type should be sent, for performance purpose only a notification
// is given here, details about the message should be queried from SfxViewShell when necessary.
// This is used for messages that are generated often but only the last one is needed.
virtual void libreOfficeKitViewUpdatedCallback(int nType) = 0;
// Like libreOfficeKitViewUpdatedCallback(), but a last message is needed for each nViewId value.
// SfxViewShell:getLOKPayload() will be called on nSourceViewId view.
virtual void libreOfficeKitViewUpdatedCallbackPerViewId(int nType, int nViewId,
int nSourceViewId)
= 0;
virtual void dumpState(rtl::OStringBuffer& rState) = 0;
};
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */