LibreOffice
LibreOffice 7.4 SDK API Reference
Public Member Functions | List of all members
XInterface Interface Referencepublished

base interface of all UNO interfaces More...

import"XInterface.idl";

Inheritance diagram for XInterface:
OleApplicationRegistration ApplicationRegistration ContentProviderProxy XAccessible XAccessibleAction XAccessibleComponent XAccessibleContext XAccessibleContext3 XAccessibleEventBroadcaster XAccessibleExtendedAttributes XAccessibleGroupPosition XAccessibleImage XAccessibleKeyBinding XAccessibleRelationSet XAccessibleSelection XAccessibleStateSet XAccessibleTable XAccessibleTableSelection XAccessibleText XAccessibleTextSelection XAccessibleValue XSSOContext XSSOManager XSSOManagerFactory XSSOPasswordCache XBitmap XButton XCheckBox XComboBox XContainerWindowEventHandler XContainerWindowProvider XControlContainer XControlModel XCurrencyField XDataTransferProviderAccess XDateField XDevice XDialog XDialogEventHandler XDialogProvider XDisplayBitmap XDisplayConnection XDockableWindow XEventHandler XExtendedToolkit XFileDialog XFixedHyperlink XFixedText XFont XFontMappingUse XGraphics XImageButton XImageConsumer XImageProducer XItemEventBroadcaster XLayoutConstrains XListBox XMenu XMessageBoxFactory XMetricField XNumericField XPatternField XPointer XPrinterServer XProgressBar XRadioButton XRegion XReschedule XScrollBar XSimpleTabController XSpinField XSpinValue XSystemChildFactory XSystemDependentMenuPeer XSystemDependentWindowPeer XTabController XTabControllerModel XTextArea XTextComponent XTextEditField XTextLayoutConstrains XTimeField XToolkit XTopWindow XUnitConversion XUnoControlContainer XUserInputInterception XVclContainer XVclContainerPeer XView XExactName XFastPropertySet XHierarchicalPropertySet XHierarchicalPropertySetInfo XIntrospection XIntrospectionAccess XMaterialHolder XMultiHierarchicalPropertySet XMultiPropertySet XMultiPropertyStates XPropertiesChangeNotifier XProperty XPropertyAccess XPropertyContainer XPropertySet XPropertySetInfo XPropertySetInfoChangeNotifier XPropertySetOption XPropertyState XPropertyWithState XTolerantMultiPropertySet XBridge XBridgeFactory XBridgeSupplier XBridgeSupplier2 XInstanceProvider XProtocolProperties XUnoUrlResolver XAutomationObject XAxis XChartShape XChartShapeContainer XChartType XChartTypeContainer XChartTypeManager XChartTypeTemplate XColorScheme XCoordinateSystem XCoordinateSystemContainer XDataProviderAccess XDataSeries XDataSeriesContainer XDefaultSizeTransmitter XDiagram XDiagramProvider XFormattedString XLegend XRegressionCurve XRegressionCurveCalculator XRegressionCurveContainer XScaling XTarget XTimeBased XTitle XTitled XDataProvider XDataReceiver XDataSequence XDataSink XDataSource XLabeledDataSequence XNumericalDataSequence XPivotTableDataProvider XRangeHighlighter XRangeXMLConversion XSheetDataProvider XTextualDataSequence X3DDefaultSetter X3DDisplay XAxis XAxisSupplier XAxisXSupplier XAxisYSupplier XAxisZSupplier XChartData XDiagramPositioning XSecondAxisTitleSupplier XStatisticDisplay XTemplateContainer XTemplateInstance XBackend XBackendChangesNotifier XBackendEntities XLayer XLayerContentDescriber XLayerHandler XLayerImporter XMultiLayerStratum XSchema XSchemaHandler XSchemaSupplier XSingleLayerStratum XUpdateHandler XAcceptor XConnection XConnectionBroadcaster XConnector XChild XContainer XContainerQuery XContentEnumerationAccess XElementAccess XEnumeration XHierarchicalName XHierarchicalNameAccess XImplicitIDReplace XNamed XUniqueIDAccess XDataFormatTranslator XMimeContentType XMimeContentTypeFactory XSystemTransferable XTransferDataAccess XTransferable XTransferableEx XTransferableSource XClipboard XClipboardFactory XClipboardManager XClipboardNotifier XClipboardOwner XFlushableClipboard XAutoscroll XDragGestureRecognizer XDragSource XDragSourceContext XDropTarget XDropTargetDragContext XDropTargetDropContext OleEmbeddedServerRegistration XActionLockable XBinaryStreamResolver XCmisDocument XDocumentInsertable XDocumentLanguages XDocumentRevisionListPersistence XDocumentSubStorageSupplier XEmbeddedObjectResolver XEmbeddedObjectSupplier XEventBroadcaster XEventsSupplier XExporter XExtendedFilterDetection XFilter XFilterAdapter XGraphicObjectResolver XGraphicStorageHandler XImporter XLinkTargetSupplier XMimeTypeInfo XOOXMLDocumentPropertiesImporter XRedlinesSupplier XStorageBasedDocument XTypeDetection XVbaMethodParameter XViewDataSupplier XConnectableShape XCustomShapeEngine XCustomShapeHandle XDrawPageDuplicator XDrawPageExpander XDrawPageSummarizer XDrawPageSupplier XDrawPagesSupplier XDrawView XEnhancedCustomShapeDefaulter XGluePointsSupplier XLayerSupplier XMasterPageTarget XMasterPagesSupplier XShapeAligner XShapeArranger XShapeBinder XShapeCombiner XShapeDescriptor XShapeGrouper XShapeMirror XActionsApproval XClassifiedObject XCommonEmbedPersist XComponentSupplier XEmbedObjectClipboardCreator XEmbedObjectCreator XEmbedObjectFactory XEncryptionProtectedSource XHatchWindowController XHatchWindowFactory XInplaceClient XInplaceObject XInsertObjectDialog XLinkCreator XLinkFactory XPackageStructureCreator XPersistanceHolder XRelationshipAccess XStateChangeBroadcaster XTransactedObject XTransactionBroadcaster XTransferableSupplier XVisualObject XWindowSupplier XApproveActionBroadcaster XBoundControl XChangeBroadcaster XConfirmDeleteBroadcaster XDatabaseParameterBroadcaster XErrorBroadcaster XFormsSupplier XGrid XGridColumnFactory XGridFieldDataSupplier XGridPeer XImageProducerSupplier XLoadable XReset XSubmit XUpdateBroadcaster XBindableValue XListEntrySink XListEntrySource XValueBinding XSubmission XSubmissionSupplier XValidatable XValidator XBrowseHistoryRegistry XComponentLoader XComponentRegistry XConfigManager XControlNotificationListener XControllerBorder XDesktop XDispatch XDispatchHelper XDispatchInformationProvider XDispatchProvider XDispatchProviderInterception XDispatchRecorder XDispatchRecorderSupplier XDocumentTemplates XExtendedFilterDetection XFilterDetect XFrameLoader XFrameLoaderQuery XFrameSetModel XInfobarProvider XInterceptorInfo XLayoutManager XLayoutManagerEventBroadcaster XLoadable XMenuBarAcceptor XMenuBarMergingAcceptor XModule XModuleManager XPopupMenuController XRecordableDispatch XSessionManagerClient XStorable XSubToolbarController XSynchronousDispatch XSynchronousFrameLoader XTasksSupplier XTitle XTitleChangeBroadcaster XToolbarController XToolbarControllerListener XTransientDocumentsDocumentContentFactory XTransientDocumentsDocumentContentIdentifierFactory XUIControllerRegistration XUntitledNumbers XUrlList XWindowArranger XGalleryItem XMapping2D XEmfParser XGraphic XGraphicObject XGraphicProvider XGraphicRasterizer XGraphicRenderer XGraphicTransformer XPdfDecomposer XPrimitive2D XPrimitive2DRenderer XPrimitive3D XPrimitiveFactory2D XSvgParser XBreakIterator XCalendar XCharacterClassification XCollator XForbiddenCharacters XIndexEntrySupplier XInputSequenceChecker XLocaleData XNativeNumberSupplier XNumberFormatCode XOrdinalSuffix XScriptTypeDetector XTextConversion XTransliteration DefaultHelpProvider XActiveDataControl XActiveDataSink XActiveDataSource XActiveDataStreamer XConnectable XDataExporter XDataImporter XInputStream XInputStreamProvider XMarkableStream XOutputStream XPersist XPersistObject XSeekable XStream XTruncate XXMLExtractor XJavaThreadRegister_11 XJavaVM XComponent XConnectionPoint XConnectionPointContainer XEventListener XInitialization XLocalizable XMain XMultiComponentFactory XMultiServiceFactory XServiceDisplayName XServiceInfo XServiceName XSingleComponentFactory XSingleServiceFactory XTypeProvider XUnoTunnel XAvailableLocales XConversionDictionary XConversionDictionaryList XConversionPropertyType XDictionaryEntry XDictionaryList XHyphenatedWord XLinguServiceEventBroadcaster XLinguServiceManager XMeaning XPossibleHyphens XProofreadingIterator XSetSpellAlternatives XSpellAlternatives XSupportedLanguages XSupportedLocales XImplementationLoader XAuthenticator XMailMessage XMailService XMailServiceProvider XPlayerNotifier XCloseSessionListener XCodeProxy XMenuProxyListener XProfileDiscover XProfileManager XProxyRunner XDataSinkEncrSupport XPackageEncryption XManifestReader XManifestWriter XZipFileAccess XCustomPresentationSupplier XHandoutMasterSupplier XPresentation XPresentationSupplier XSlideShow XSlideShowView XTransition XTransitionFactory XDumper XIdlArray XIdlClass XIdlClassProvider XIdlMember XIdlReflection XMethodParameter XProxyFactory XTypeDescription XTypeDescriptionEnumerationAccess XImplementationRegistration XRegistryKey XSimpleRegistry XAnimation XBitmap XBitmapPalette XBufferController XCachedPrimitive XCanvas XCanvasFont XGraphicDevice XMtfRenderer XParametricPolyPolygon2D XPolyPolygon2D XSimpleCanvas XSprite XTextLayout XStringResourceSupplier XScannerManager XAllListenerAdapterService XDebugging XDefaultMethod XDefaultProperty XDirectInvocation XEngine XErrorQuery XEventAttacher XEventAttacherManager XInvocation XInvocationAdapterFactory XInvocationAdapterFactory2 XLibraryAccess XLibraryContainerExport XLibraryContainerPassword XLibraryQueryExecutable XScriptEventsAttacher XScriptEventsSupplier XStarBasicAccess XStarBasicDialogInfo XStarBasicLibraryInfo XStarBasicModuleInfo XTypeConverter XBrowseNode XBrowseNodeFactory XScript XScriptContext XScriptProvider XScriptProviderFactory XScriptProviderSupplier XScriptURIHelper XAlterQuery XBookmarksSupplier XColumn XColumnUpdate XCommandPreparation XCompletedConnection XCompletedExecution XFormDocumentsSupplier XParametersSupplier XQueriesSupplier XQueryDefinitionsSupplier XReportDocumentsSupplier XResultSetAccess XRowSetApproveBroadcaster XRowSetSupplier XSQLErrorBroadcaster XSQLQueryComposer XSQLQueryComposerFactory XSingleSelectQueryAnalyzer XArray XBatchExecution XBlob XClob XCloseable XColumnLocate XDataSource XDatabaseMetaData XDriver XDriverAccess XDriverManager XGeneratedResultSet XIsolatedConnection XMultipleResults XOutParameters XParameters XPooledConnection XPreparedBatchExecution XPreparedStatement XRef XResultSet XResultSetMetaData XResultSetMetaDataSupplier XResultSetUpdate XRow XRowUpdate XSQLData XSQLInput XSQLOutput XStatement XStruct XWarningsSupplier XAlterTable XAppend XAuthorizable XColumnsSupplier XCreateCatalog XDataDefinitionSupplier XDataDescriptorFactory XDeleteRows XDrop XDropCatalog XGroupsSupplier XIndexesSupplier XKeysSupplier XRename XRowLocate XTablesSupplier XUsersSupplier XViewsSupplier XAccessControlContext XAccessController XAction XCertificate XCertificateExtension XDocumentDigitalSignatures XPolicy XActivationBroadcaster XAreaLink XArrayFormulaRange XCalculatable XCellAddressable XCellFormatRangesSupplier XCellRangeAddressable XCellRangeData XCellRangeFormula XCellRangeMovement XCellRangeReferrer XCellRangesAccess XCellRangesQuery XCellSeries XCompatibilityNames XConditionEntry XConditionalFormats XConsolidatable XConsolidationDescriptor XDDELink XDDELinkResults XDataPilotField XDataPilotFieldGrouping XDataPilotMemberResults XDataPilotResults XDataPilotTable XDataPilotTablesSupplier XDatabaseRange XDimensionsSupplier XDocumentAuditing XDrillDownDataSupplier XEnhancedMouseClickBroadcaster XExternalSheetName XFillAcrossSheet XFormulaQuery XFunctionAccess XGoalSeek XHeaderFooterContent XHierarchiesSupplier XLabelRange XLevelsSupplier XMembersSupplier XMultipleOperation XPrintAreas XRangeSelection XRecentFunctions XScenario XScenarioEnhanced XScenariosSupplier XSelectedSheetsSupplier XSheetAnnotation XSheetAnnotationAnchor XSheetAnnotationShapeSupplier XSheetAnnotationsSupplier XSheetAuditing XSheetCondition XSheetConditionalEntry XSheetFilterDescriptor XSheetFilterDescriptor2 XSheetFilterDescriptor3 XSheetFilterable XSheetLinkable XSheetOperation XSheetOutline XSheetPageBreak XSheetPastable XSolver XSolverDescription XSpreadsheetDocument XSpreadsheetView XSubTotalCalculatable XSubTotalDescriptor XSubTotalField XUniqueCellFormatRangesSupplier XUnnamedDatabaseRanges XUsedAreaCursor XViewFreezable XViewPane XViewPanesSupplier XViewSplitable XVolatileResult XOpenCLSelection XAutoStylesSupplier XDefaultsSupplier XStyleFamiliesSupplier XStyleLoader XStyleSupplier XSVGPrinter XSVGWriter XSimpleMailClient XSimpleMailClientSupplier XSimpleMailMessage XSystemShellExecute XJumpList XAutoFormattable XCell XCellRange XColumnRowRange XMergeableCellRange XTableChart XTableChartsSupplier XTablePivotChart XTablePivotChartsSupplier XAsyncJob XInteractionContinuation XInteractionHandler XInteractionRequest XInteractionRequestStringResolver XJob XJobExecutor XMasterPasswordHandling XPasswordContainer XRestartManager XStatusIndicator XStatusIndicatorFactory XStatusIndicatorSupplier XUrlContainer XAutoTextEntry XBookmarkInsertTool XBookmarksSupplier XChapterNumberingSupplier XDefaultNumberingProvider XDocumentIndexesSupplier XEndnotesSettingsSupplier XEndnotesSupplier XFlatParagraphIterator XFlatParagraphIteratorProvider XFootnotesSettingsSupplier XFootnotesSupplier XFormField XLineNumberingProperties XMailMergeBroadcaster XMailMergeListener XNumberingFormatter XNumberingRulesSupplier XNumberingTypeInfo XPageCursor XPagePrintable XParagraphAppend XPasteBroadcaster XPasteListener XReferenceMarksSupplier XRelativeTextContentInsert XRelativeTextContentRemove XRubySelection XTextColumns XTextContentAppend XTextConvert XTextCopy XTextEmbeddedObjectsSupplier XTextFieldsSupplier XTextFramesSupplier XTextGraphicObjectsSupplier XTextPortionAppend XTextRange XTextRangeCompare XTextRangeMover XTextSectionsSupplier XTextShapesSupplier XTextTableCursor XTextTablesSupplier XTextViewCursorSupplier XTextViewTextRangeSupplier XTiledRenderable XAnyCompare XAnyCompareFactory XCachedContentResultSetFactory XCachedContentResultSetStubFactory XCachedDynamicResultSetFactory XCachedDynamicResultSetStubFactory XCommandEnvironment XCommandInfo XCommandInfoChangeNotifier XCommandProcessor XContent XContentAccess XContentCreator XContentIdentifier XContentIdentifierFactory XContentIdentifierMapping XContentProvider XContentProviderFactory XContentProviderManager XContentProviderSupplier XContentTransmitter XFetchProvider XFetchProviderForContentAccess XFileIdentifierConverter XInteractionHandlerSupplier XParameterizedContentProvider XProgressHandler XPropertyMatcher XPropertyMatcherFactory XPropertySetRegistry XPropertySetRegistryFactory XRecycler XRemoteContentProviderAcceptor XRemoteContentProviderActivator XRemoteContentProviderChangeNotifier XRemoteContentProviderConnectionControl XRemoteContentProviderDistributor XRemoteContentProviderDoneListener XRemoteContentProviderSupplier XSimpleFileAccess XSortedDynamicResultSetFactory XSourceInitialization XContextChangeEventMultiplexer XContextMenuInterception XContextMenuInterceptor XDockingAreaAcceptor XModuleUIConfigurationManager XModuleUIConfigurationManagerSupplier XSidebarProvider XUIConfiguration XUIConfigurationManager XUIConfigurationManagerSupplier XUIConfigurationPersistence XUIConfigurationStorage XUIElement XUIElementFactory XUIElementFactoryRegistration XUIElementSettings XUpdateModel XAsynchronousExecutableDialog XControlAccess XControlInformation XExecutableDialog XFilePickerNotifier XFilePreview XFilterGroupManager XFilterManager XAdapter XAggregation XComponentContext XCurrentContext XNamingService XReference XUnloadingPreference XWeak XUriReference XUriReferenceFactory XUriSchemeParser XVndSunStarScriptUrl XAccounting XAtomServer XBroadcaster XCacheInfo XCancellable XChainable XChangesBatch XChangesNotifier XCloneable XCloseBroadcaster XDataEditor XDataEditorListener XFlushable XImportable XIndent XJobManager XLinkUpdate XLocalizedAliases XMacroExpander XMergeable XModeChangeBroadcaster XModeSelector XModifyBroadcaster XNumberFormatPreviewer XNumberFormatTypes XNumberFormats XNumberFormatsSupplier XNumberFormatter XOfficeInstallationDirectories XProtectable XRefreshable XSearchable XSortable XStringAbbreviation XStringEscape XStringMapping XStringSubstitution XStringWidth XTextSearch XTimeStamped XURLTransformer XUniqueIDFactory XUpdatable XControlAccess XLineCursor XPrintJob XPrintJobBroadcaster XPrintSettingsSupplier XPrintable XPrintableBroadcaster XRenderable XScreenCursor XSelectionSupplier XViewCursor XViewSettingsSupplier XFormsSupplier XExportFilter XImportFilter XImportFilter2 XCertificateCreator XCipherContext XCipherContextSupplier XDigestContext XDigestContextSupplier XSEInitializer XSecurityEnvironment XUriBinding XXMLEncryption XXMLSecurityContext XXMLSecurityTemplate XXMLSignature XBlockerMonitor XDecryptionResultBroadcaster XDecryptionResultListener XElementStackKeeper XEncryptionResultBroadcaster XEncryptionResultListener XKeyCollector XMissionTaker XReferenceCollector XReferenceResolvedBroadcaster XReferenceResolvedListener XSAXEventKeeper XSAXEventKeeperStatusChangeBroadcaster XSAXEventKeeperStatusChangeListener XSignatureCreationResultBroadcaster XSignatureCreationResultListener XSignatureVerifyResultBroadcaster XSignatureVerifyResultListener XCompressedDocumentHandler XDOMImplementation XDocumentBuilder XNamedNodeMap XNode XNodeList XSAXDocumentBuilder XDocumentEvent XEvent XEventListener XEventTarget XAbstractView XDocumentView XAttributes XElement XNamespaceMapping XRoot XAttributeList XDTDHandler XDocumentHandler XEntityResolver XErrorHandler XFastAttributeList XFastContextHandler XFastNamespaceHandler XFastParser XFastTokenHandler XLocator XParser XXMLDocumentWrapper XXMLElementWrapper XXPathAPI XXPathExtension XXPathObject XModify XQuery

Public Member Functions

any queryInterface ([in] type aType)
 queries for a new interface to an existing UNO object. More...
 
void acquire ()
 increases the reference counter by one. More...
 
void release ()
 decreases the reference counter by one. More...
 

Detailed Description

base interface of all UNO interfaces

It provides lifetime control by reference counting and the possibility of querying for other interfaces of the same logical object.

"Logical Object" in this case means that the interfaces actually can be supported by internal (e.g. aggregated) physical objects.

Deriving from this interface is mandatory for all UNO interfaces.

Each language binding (Java, C++, StarBasic, Python, ... ) may provide a different mapping of this interface, please look into the language dependent documentation.

The UNO object does not export the state of the reference count (acquire() and release() do not have return values). In general, also the UNO object itself should not make any assumption on the concrete value of the reference count (except on the transition from one to zero ).

Developers Guide
Professional UNO - Lifetime of UNO objects
First Steps - Using Services - Using Interfaces
Professional UNO - Using UNO Interfaces
Writing UNO Components - XInterface
Writing UNO Components - Core Interfaces to Implement

Member Function Documentation

◆ acquire()

void acquire ( )

increases the reference counter by one.

When you have called acquire() on the UNO object, it is often said, that you have a reference or a hard reference to the object.

It is only allowed to invoke a method on a UNO object, when you keep a hard reference to it.

Every call to acquire must be followed by a corresponding call to release some time later, which may eventually lead to the destruction of the object.

◆ queryInterface()

any queryInterface ( [in] type  aType)

queries for a new interface to an existing UNO object.

The queryInterface() method is the entry point to obtain other interfaces which are exported by the object. The caller asks the implementation of the object, if it supports the interface specified by the type argument. The call may either return with an interface reference of the requested type or with a void any.

There are certain specifications, a queryInterface() implementation must not violate.

1) If queryInterface on a specific object has once returned a valid interface reference for a given type, it must return a valid reference for any successive queryInterface calls on this object for the same type.

2) If queryInterface on a specific object has once returned a null reference for a given type, it must always return a null reference for the same type.

3) If queryInterface on a reference A returns reference B, queryInterface on B for Type A must return interface reference A or calls made on the returned reference must be equivalent to calls made on reference A.

4) If queryInterface on a reference A returns reference B, queryInterface on A and B for XInterface must return the same interface reference (object identity).

The reason for the strong specification is, that a Uno Runtime Environment (URE) may choose to cache queryInterface() calls.

As mentioned above, certain language bindings may map this function differently also with different specifications, please visit the language dependent specification for it. The current C++ binding sticks to the specification state

The rules mentioned above are basically identical to the rules of QueryInterface in MS COM.

Parameters
aTypea UNO interface type, for which an object reference shall be obtained.
Returns
an interface reference in case the requested interface is supported by the object, a void any otherwise.

◆ release()

void release ( )

decreases the reference counter by one.

When the reference counter reaches 0, the object gets deleted.

Calling release() on the object is often called releasing or clearing the reference to an object.


The documentation for this interface was generated from the following file: