| Quellcodebibliothek Statistik Leitseite products/Sources/formale Sprachen/C/LibreOffice/udkapi/com/sun/star/uno/ (LibreOffice Version 25.8.3.2©) Datei vom 5.10.2025 mit Größe 3 kB |
|
Quelle XWeak.idl Sprache: 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/. * * 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 uno { /** the server-side interface to a weak object. <p>This interface is proxy to the adapted object. In order to make it possible to have weak references to objects, the XAdapter interface must be implemented to provide a weak adapter for the clients. <h4>Concept of weak referencing:</h4> </p> <p>This module specifies the interfaces for implementing and using weak references.</p> <p> </p> <p>The sense of weak references is to hold a reference to an object without affecting the lifetime of the object. That means that a weak reference may become invalid, at any time, if the referenced object dies. </p> <p>The following interfaces describe one way to handle weak references by providing a weak adapter. The weak object has to provide this adapter if anyone wants to hold a weak reference. To separate their lifetimes, the adapter and the original object must not share the same reference counter. The weak reference is in fact only a hard reference to the adapter, which knows - but does not hold - the original object. That means that the implementation and synchronization of weak referencing is the responsibility of the object. The following interfaces are involved in the concept of weak referencing: <dl> <dt> XWeak </dt> <dd>is the server-side interface of the referred object. This referred object must support the XAdapter interface. </dd> <dt> XReference </dt> <dd>is a client-side interface which must be implemented by the holder of any weak reference. It is used for notification when the adapted object dies. </dd> </dl> </p> */ published interface XWeak: com::sun::star::uno::XInterface { /** queries the weak adapter. <p>It is important that the adapter must know, but not hold the adapted object. If the adapted object dies, all references to the adapter have to be notified to release the adapter. </p> */ com::sun::star::uno::XAdapter queryAdapter(); }; }; }; }; }; /* vim:set shiftwidth=4 softtabstop=4 expandtab: */
¤ Dauer der Verarbeitung: 0.4 Sekunden ¤*© Formatika GbR, Deutschland |
|
||||||||||||||
2026-10-11