From 267c6f2ac71f92999e969232431ba04678e7437e Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 07:54:39 +0200 Subject: Adding upstream version 4:24.2.0. Signed-off-by: Daniel Baumann --- offapi/com/sun/star/util/XBroadcaster.idl | 66 +++++++++++++++++++++++++++++++ 1 file changed, 66 insertions(+) create mode 100644 offapi/com/sun/star/util/XBroadcaster.idl (limited to 'offapi/com/sun/star/util/XBroadcaster.idl') diff --git a/offapi/com/sun/star/util/XBroadcaster.idl b/offapi/com/sun/star/util/XBroadcaster.idl new file mode 100644 index 0000000000..cb8fb6de44 --- /dev/null +++ b/offapi/com/sun/star/util/XBroadcaster.idl @@ -0,0 +1,66 @@ +/* -*- 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/. + * + * This file incorporates work covered by the following license notice: + * + * Licensed to the Apache Software Foundation (ASF) under one or more + * contributor license agreements. See the NOTICE file distributed + * with this work for additional information regarding copyright + * ownership. The ASF licenses this file to you under the Apache + * License, Version 2.0 (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.apache.org/licenses/LICENSE-2.0 . + */ + + +module com { module sun { module star { module util { + + +/** allows to control notification behavior of a broadcaster. + + @since OOo 3.0 + */ +interface XBroadcaster: com::sun::star::uno::XInterface +{ + /** suspends broadcasts to the registered listeners. + +

+ The calls to XBroadcaster::lockBroadcasts() and + XBroadcaster::unlockBroadcasts() may be + nested and even overlapping, but they must be in pairs. While + there is at least one lock remaining, no broadcasts are + sent to registered listeners. +

+ */ + void lockBroadcasts(); + + /** resumes the broadcasts which were suspended by + XBroadcaster::lockBroadcasts(). + +

+ The calls to XBroadcaster::lockBroadcasts() and + XBroadcaster::unlockBroadcasts() may be + nested and even overlapping, but they must be in pairs. While + there is at least one lock remaining, no broadcasts are + sent to registered listeners. +

+ +

Pending broadcasts will be sent immediately after the last + call to XBroadcaster::lockBroadcasts() is matched + by a call to XBroadcaster::unlockBroadcasts(). + An implementation can decide to broadcast all pending notification in + order or batch them in single broadcasts. +

+ */ + void unlockBroadcasts(); +}; + + +}; }; }; }; + +/* vim:set shiftwidth=4 softtabstop=4 expandtab: */ -- cgit v1.2.3