windowstateguard.hxx (2d785d7e) windowstateguard.hxx (7950f2af)
1/**************************************************************
2 *
3 * Licensed to the Apache Software Foundation (ASF) under one
4 * or more contributor license agreements. See the NOTICE file
5 * distributed with this work for additional information
6 * regarding copyright ownership. The ASF licenses this file
7 * to you under the Apache License, Version 2.0 (the
8 * "License"); you may not use this file except in compliance

--- 35 unchanged lines hidden (view full) ---

44 that they're consistent with respective properties at an XModel.
45
46 For form controls, window states - such as "Enabled" - can be set by various
47 means. You can set the respective control model property, you can directly manipulate
48 the XWindow2, or the state can change implicitly due to VCL actions. In any case,
49 we need to ensure that the state does not contradict the model property "too much".
50
51 As an example, consider a form control which, according to its model's property, is disabled.
1/**************************************************************
2 *
3 * Licensed to the Apache Software Foundation (ASF) under one
4 * or more contributor license agreements. See the NOTICE file
5 * distributed with this work for additional information
6 * regarding copyright ownership. The ASF licenses this file
7 * to you under the Apache License, Version 2.0 (the
8 * "License"); you may not use this file except in compliance

--- 35 unchanged lines hidden (view full) ---

44 that they're consistent with respective properties at an XModel.
45
46 For form controls, window states - such as "Enabled" - can be set by various
47 means. You can set the respective control model property, you can directly manipulate
48 the XWindow2, or the state can change implicitly due to VCL actions. In any case,
49 we need to ensure that the state does not contradict the model property "too much".
50
51 As an example, consider a form control which, according to its model's property, is disabled.
52 Now when the parent VCL window of the control's VCL window is enabled, then the the control's
52 Now when the parent VCL window of the control's VCL window is enabled, then the control's
53 window is enabled, too - which contradicts the model property.
54
55 A WindowStateGuard helps you preventing such inconsistent states.
56
57 The class is not threadsafe.
58 */
59 class WindowStateGuard
60 {

--- 19 unchanged lines hidden ---
53 window is enabled, too - which contradicts the model property.
54
55 A WindowStateGuard helps you preventing such inconsistent states.
56
57 The class is not threadsafe.
58 */
59 class WindowStateGuard
60 {

--- 19 unchanged lines hidden ---