Adding a recommendation for the usage of setLocation in Control

Setting the location of the control before setting its size could cause
a
DPI_CHANGE event in win32 since the OS is responsible for providing
the size to the control upon creation and this size can be very big,
causing
the control to span across multiple monitors.

Author: ShahzaibIbrahim

bundles/org.eclipse.swt/Eclipse SWT/cocoa/org/eclipse/swt/widgets/Control.java

@@ -3991,6 +3991,10 @@ public void setLayoutData (Object layoutData) {
  * @param x the new x coordinate for the receiver
  * @param y the new y coordinate for the receiver
  *
+ * <p><strong>Recommended Usage:</strong> If you plan to use {@link #setSize(int, int)},
+ * call it <em>before</em> calling this method. This ensures the control is sized
+ * correctly before positioning, which helps avoid layout issues when using absolute positioning.</p>
+ *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -4013,6 +4017,10 @@ public void setLocation (int x, int y) {
  *
  * @param location the new location for the receiver
  *
+ * <p><strong>Recommended Usage:</strong> If you plan to use {@link #setSize(int, int)},
+ * call it <em>before</em> calling this method. This ensures the control is sized
+ * correctly before positioning, which helps avoid layout issues when using absolute positioning.</p>
+ *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>

bundles/org.eclipse.swt/Eclipse SWT/gtk/org/eclipse/swt/widgets/Control.java

@@ -1260,6 +1260,10 @@ Point getLocationInPixels () {
  *
  * @param location the new location for the receiver
  *
+ * <p><strong>Recommended Usage:</strong> If you plan to use {@link #setSize(int, int)},
+ * call it <em>before</em> calling this method. This ensures the control is sized
+ * correctly before positioning, which helps avoid layout issues when using absolute positioning.</p>
+ *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>
@@ -1290,6 +1294,10 @@ void setLocationInPixels (Point location) {
  * @param x the new x coordinate for the receiver
  * @param y the new y coordinate for the receiver
  *
+ * <p><strong>Recommended Usage:</strong> If you plan to use {@link #setSize(int, int)},
+ * call it <em>before</em> calling this method. This ensures the control is sized
+ * correctly before positioning, which helps avoid layout issues when using absolute positioning.</p>
+ *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>

bundles/org.eclipse.swt/Eclipse SWT/win32/org/eclipse/swt/widgets/Control.java

@@ -3504,8 +3504,9 @@ public void setLayoutData (Object layoutData) {
  * intended effect on some platforms. For example, executing this operation on a
  * shell when the environment uses the Wayland protocol, nothing will happen.
  *
- * @param x the new x coordinate for the receiver
- * @param y the new y coordinate for the receiver
+ * <p><strong>Recommended Usage:</strong> If you plan to use {@link #setSize(int, int)},
+ * call it <em>before</em> calling this method. This ensures the control is sized
+ * correctly before positioning, which helps avoid layout issues when using absolute positioning.</p>
  *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
@@ -3537,6 +3538,10 @@ void setLocationInPixels (int x, int y) {
  *
  * @param location the new location for the receiver
  *
+ * <p><strong>Recommended Usage:</strong> If you plan to use {@link #setSize(int, int)},
+ * call it <em>before</em> calling this method. This ensures the control is sized
+ * correctly before positioning, which helps avoid layout issues when using absolute positioning.</p>
+ *
  * @exception SWTException <ul>
  *    <li>ERROR_WIDGET_DISPOSED - if the receiver has been disposed</li>
  *    <li>ERROR_THREAD_INVALID_ACCESS - if not called from the thread that created the receiver</li>