1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141
|
/* -*- 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 embed {
/** represents common visualization functionality for embedded objects.
*/
published interface XVisualObject: ::com::sun::star::uno::XInterface
{
/** sets the size of object's visual area.
<p>
The size must be provided in logical units according to map mode the
object communicates in.
</p>
<p>
If an object is inplace- or ui-active the method must not initiate
repainting itself.
</p>
@param nAspect
the aspect specifying the form of object representation.
Can take values from Aspects constant set.
@param aSize
the new size of the visual area
@throws ::com::sun::star::lang::IllegalArgumentException
one of arguments is illegal
@throws ::com::sun::star::embed::WrongStateException
the object is in wrong state
@throws ::com::sun::star::uno::Exception
the object failed to resize
*/
void setVisualAreaSize( [in] hyper nAspect,
[in] ::com::sun::star::awt::Size aSize )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::embed::WrongStateException,
::com::sun::star::uno::Exception );
/** gets the size of object's visual area.
<p>
The size must be provided in logical units according to map mode the
object communicates in.
</p>
@param nAspect
the aspect specifying the form of object representation.
Can take values from Aspects constant set.
@return
the size of visual area
@throws ::com::sun::star::lang::IllegalArgumentException
one of arguments is illegal
@throws ::com::sun::star::embed::WrongStateException
the object is in wrong state
*/
::com::sun::star::awt::Size getVisualAreaSize( [in] hyper nAspect )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::embed::WrongStateException,
::com::sun::star::uno::Exception );
/** retrieves visual representation of the object in preferable format.
<p>
If the object persistence entry contains cached visual representation
then it can be retrieved by using this method even in loaded state.
</p>
@param nAspect
the aspect the representation is requested for.
Can take values from Aspects constant set.
@return
the visual representation of the object in the default format and
the format
@throws ::com::sun::star::lang::IllegalArgumentException
one of arguments is illegal
@throws ::com::sun::star::embed::WrongStateException
the object is in wrong state
@throws ::com::sun::star::uno::Exception
in case of problems
*/
VisualRepresentation getPreferredVisualRepresentation( [in] hyper nAspect )
raises( ::com::sun::star::lang::IllegalArgumentException,
::com::sun::star::embed::WrongStateException,
::com::sun::star::uno::Exception );
/** retrieves map mode the object communicates in.
@param nAspect
the aspect the map mode is requested for.
Can take values from Aspects constant set.
@return
the map mode the object communicates in, it can take values from
EmbedMapUnits constant
@throws ::com::sun::star::embed::WrongStateException
the object is in wrong state
@throws ::com::sun::star::uno::Exception
in case of problems
*/
long getMapUnit( [in] hyper nAspect )
raises( ::com::sun::star::uno::Exception );
};
}; }; }; };
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|