/**************************************************************
*
* 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
*
* Unless required by applicable law or agreed to in writing,
* software distributed under the License is distributed on an
* "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
* KIND, either express or implied. See the License for the
* specific language governing permissions and limitations
* under the License.
*
*************************************************************/
#ifndef __com_sun_star_frame_XComponentLoader_idl__
#define __com_sun_star_frame_XComponentLoader_idl__
#ifndef __com_sun_star_uno_XInterface_idl__
#include
To create new documents, use "private:factory/scalc", "private:factory/swriter", etc.
Other special protocols (e.g. "slot:", ".uno") are not allowed and raise
an
If a frame with the specified name already exists, it is used, otherwise it
is created. There exist some special targets which never can be used
as real frame names:
Note: These flags are optional ones and will be used for non special
target names only.
For example, "ReadOnly" with a boolean value specifies whether
the document is opened read-only. "FilterName" specifies the
component type to create and the filter to use, for example:
"Text - CSV". For more information see
This interface is a generic one and can be used to start further requests on
loaded document or control the lifetime of it (means dispose() it after using).
The real document service behind this interface can be one of follow three ones:
@param SearchFlags
use the values of
"_blank"
always creates a new frame
"_default"
special UI functionality
(e.g. detecting of already loaded documents, using of empty frames of creating of new top frames as fallback)
"_self", ""(!)
means frame himself
"_parent"
address direct parent of frame
"_top"
indicates top frame of current path in tree
"_beamer"
means special sub frame
Should be used for viewable components only. It is not allowed to dispose
it after use directly, because the frame containing the component is its owner.
Because the frame object is not accessible through the interface too,
only an interacting user can do this by closing the frames' window.
Should be used for real editable components which doesn't need a model.
It is not allowed to dispose it after use directly, because the frame
containing the component is its owner. Here the object can be disposed
by disposing the frame, that the
A model that in general can be shared between several view/controller pairs,
does not have an explicit owner. Every view and also the component that
loaded the document may consider itself as an owner.
Simply calling