PCL
UIObject.h
Go to the documentation of this file.
1
// ____ ______ __
2
// / __ \ / ____// /
3
// / /_/ // / / /
4
// / ____// /___ / /___ PixInsight Class Library
5
// /_/ \____//_____/ PCL 2.6.5
6
// ----------------------------------------------------------------------------
7
// pcl/UIObject.h - Released 2024-01-13T15:47:58Z
8
// ----------------------------------------------------------------------------
9
// This file is part of the PixInsight Class Library (PCL).
10
// PCL is a multiplatform C++ framework for development of PixInsight modules.
11
//
12
// Copyright (c) 2003-2024 Pleiades Astrophoto S.L. All Rights Reserved.
13
//
14
// Redistribution and use in both source and binary forms, with or without
15
// modification, is permitted provided that the following conditions are met:
16
//
17
// 1. All redistributions of source code must retain the above copyright
18
// notice, this list of conditions and the following disclaimer.
19
//
20
// 2. All redistributions in binary form must reproduce the above copyright
21
// notice, this list of conditions and the following disclaimer in the
22
// documentation and/or other materials provided with the distribution.
23
//
24
// 3. Neither the names "PixInsight" and "Pleiades Astrophoto", nor the names
25
// of their contributors, may be used to endorse or promote products derived
26
// from this software without specific prior written permission. For written
27
// permission, please contact info@pixinsight.com.
28
//
29
// 4. All products derived from this software, in any form whatsoever, must
30
// reproduce the following acknowledgment in the end-user documentation
31
// and/or other materials provided with the product:
32
//
33
// "This product is based on software from the PixInsight project, developed
34
// by Pleiades Astrophoto and its contributors (https://pixinsight.com/)."
35
//
36
// Alternatively, if that is where third-party acknowledgments normally
37
// appear, this acknowledgment must be reproduced in the product itself.
38
//
39
// THIS SOFTWARE IS PROVIDED BY PLEIADES ASTROPHOTO AND ITS CONTRIBUTORS
40
// "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
41
// TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
42
// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL PLEIADES ASTROPHOTO OR ITS
43
// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
44
// EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, BUSINESS
45
// INTERRUPTION; PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; AND LOSS OF USE,
46
// DATA OR PROFITS) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
47
// CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
48
// ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
49
// POSSIBILITY OF SUCH DAMAGE.
50
// ----------------------------------------------------------------------------
51
52
#ifndef __PCL_UIObject_h
53
#define __PCL_UIObject_h
54
56
57
#include <
pcl/Defs.h
>
58
59
#include <
pcl/Relational.h
>
60
#include <
pcl/String.h
>
61
62
namespace
pcl
63
{
64
65
// ----------------------------------------------------------------------------
66
94
class
PCL_CLASS
UIObject
95
{
96
public
:
97
105
virtual
~
UIObject
() noexcept(
false
);
106
113
bool
IsNull
()
const
114
{
115
return
handle ==
nullptr
;
116
}
117
124
static
UIObject
& Null();
125
134
size_type
RefCount()
const
;
135
143
bool
IsUnique
()
const
144
{
145
return
RefCount() < 2;
146
}
147
174
bool
IsAlias
()
const
175
{
176
return
alias;
177
}
178
185
bool
IsGarbage
()
const
186
{
187
return
RefCount() < 1;
188
}
189
198
bool
IsSameObject
(
const
UIObject
& o )
const
199
{
200
return
handle == o.handle;
201
}
202
217
virtual
void
EnsureUnique();
218
222
bool
operator ==
(
const
UIObject
& o )
const
223
{
224
return
IsSameObject( o );
225
}
226
237
bool
operator <
(
const
UIObject
& o )
const
238
{
239
return
handle < o.handle;
240
}
241
246
IsoString
ObjectType()
const
;
247
266
String
ObjectId()
const
;
267
276
void
SetObjectId(
const
String
&
id
);
277
278
protected
:
279
280
void
* handle =
nullptr
;
281
bool
alias =
false
;
282
289
UIObject
() =
default
;
290
299
UIObject
(
const
UIObject
& x );
300
304
UIObject
(
UIObject
&& x )
305
: handle( x.handle )
306
, alias( x.alias )
307
{
308
x.handle =
nullptr
;
309
x.alias =
false
;
310
}
311
315
UIObject
& operator =(
const
UIObject
& x )
316
{
317
Assign( x );
318
return
*
this
;
319
}
320
324
UIObject
& operator =(
UIObject
&& x )
325
{
326
Transfer( x );
327
return
*
this
;
328
}
329
333
UIObject
(
void
* );
334
338
UIObject
(
const
void
* );
339
343
UIObject
( std::nullptr_t )
344
{
345
}
346
350
void
SetHandle(
void
* );
351
355
void
TransferHandle(
void
* );
356
363
virtual
void
* CloneHandle()
const
364
{
365
return
nullptr
;
366
}
367
371
bool
Assign(
const
UIObject& x )
372
{
373
if
( x.handle != handle )
374
{
375
SetHandle( x.handle );
376
return
true
;
377
}
378
return
false
;
379
}
380
384
bool
Transfer( UIObject& x )
385
{
386
if
( &x !=
this
)
387
{
388
SetHandle(
nullptr
);
389
handle = x.handle;
390
alias = x.alias;
391
x.handle =
nullptr
;
392
x.alias =
false
;
393
return
true
;
394
}
395
return
false
;
396
}
397
398
friend
class
UIObjectIndex;
399
friend
class
UIEventDispatcher;
400
};
401
402
// ----------------------------------------------------------------------------
403
404
}
// pcl
405
406
#endif // __PCL_UIObject_h
407
408
// ----------------------------------------------------------------------------
409
// EOF pcl/UIObject.h - Released 2024-01-13T15:47:58Z
pcl
PCL root namespace.
Definition:
AbstractImage.h:76
pcl::UIObject::IsAlias
bool IsAlias() const
Definition:
UIObject.h:174
pcl::String
Unicode (UTF-16) string.
Definition:
String.h:8112
pcl::operator==
bool operator==(const Array< T, A > &x1, const Array< T, A > &x2) noexcept
Definition:
Array.h:2090
Relational.h
pcl::IsoString
Eight-bit string (ISO/IEC-8859-1 or UTF-8 string)
Definition:
String.h:5424
pcl::UIObject
Root base class for all user interface objects.
Definition:
UIObject.h:94
pcl::UIObject::IsGarbage
bool IsGarbage() const
Definition:
UIObject.h:185
pcl::size_type
size_t size_type
Definition:
Defs.h:612
pcl::UIObject::IsNull
bool IsNull() const
Definition:
UIObject.h:113
pcl::UIObject::IsUnique
bool IsUnique() const
Definition:
UIObject.h:143
String.h
pcl::UIObject::UIObject
UIObject(UIObject &&x)
Definition:
UIObject.h:304
Defs.h
pcl::UIObject::IsSameObject
bool IsSameObject(const UIObject &o) const
Definition:
UIObject.h:198
pcl::operator<
bool operator<(const Array< T, A > &x1, const Array< T, A > &x2) noexcept
Definition:
Array.h:2101
UIObject.h
Generated on Sun Jan 14 2024 20:52:44 for PCL by
1.8.17