Java Doc for GridData.java in  » IDE-Eclipse » swt » org » eclipse » swt » layout » Java Source Code / Java DocumentationJava Source Code and Java Documentation

There are two ways to create a GridData object with certain fields set. The first is to set the fields directly, like this:

 GridData gridData = new GridData();
 gridData.horizontalAlignment = GridData.FILL;
 gridData.grabExcessHorizontalSpace = true;
 button1.setLayoutData(gridData);
 

 button1.setLayoutData(new GridData(GridData.HORIZONTAL_ALIGN_FILL | GridData.GRAB_HORIZONTAL));
 

NOTE: Do not reuse GridData objects. Every control in a Composite that is managed by a GridLayout must have a unique GridData object. If the layout data for a control in a GridLayout is null at layout time, a unique GridData object is created for it.

grabExcessHorizontalSpace specifies whether the width of the cell changes depending on the size of the parent Composite.

grabExcessVerticalSpace specifies whether the height of the cell changes depending on the size of the parent Composite.

grabExcessHorizontalSpace specifies whether the width of the cell changes depending on the size of the parent Composite. If grabExcessHorizontalSpace is true, the following rules apply to the width of the cell:

• If extra horizontal space is available in the parent, the cell will grow to be wider than its preferred width. The new width will be "preferred width + delta" where delta is the extra horizontal space divided by the number of grabbing columns.
• If there is not enough horizontal space available in the parent, the cell will shrink until it reaches its minimum width as specified by GridData.minimumWidth. The new width will be the maximum of "minimumWidth" and "preferred width - delta", where delta is the amount of space missing divided by the number of grabbing columns.
• If the parent is packed, the cell will be its preferred width as specified by GridData.widthHint.
• If the control spans multiple columns and there are no other grabbing controls in any of the spanned columns, the last column in the span will grab the extra space. If there is at least one other grabbing control in the span, the grabbing will be spread over the columns already marked as grabExcessHorizontalSpace.

The default value is false.

grabExcessVerticalSpace specifies whether the height of the cell changes depending on the size of the parent Composite. If grabExcessVerticalSpace is true, the following rules apply to the height of the cell:

• If extra vertical space is available in the parent, the cell will grow to be taller than its preferred height. The new height will be "preferred height + delta" where delta is the extra vertical space divided by the number of grabbing rows.
• If there is not enough vertical space available in the parent, the cell will shrink until it reaches its minimum height as specified by GridData.minimumHeight. The new height will be the maximum of "minimumHeight" and "preferred height - delta", where delta is the amount of space missing divided by the number of grabbing rows.
• If the parent is packed, the cell will be its preferred height as specified by GridData.heightHint.
• If the control spans multiple rows and there are no other grabbing controls in any of the spanned rows, the last row in the span will grab the extra space. If there is at least one other grabbing control in the span, the grabbing will be spread over the rows already marked as grabExcessVerticalSpace.

The default value is false.

• SWT.BEGINNING (or SWT.LEFT): Position the control at the left of the cell
• SWT.CENTER: Position the control in the horizontal center of the cell
• SWT.END (or SWT.RIGHT): Position the control at the right of the cell
• SWT.FILL: Resize the control to fill the cell horizontally

• SWT.BEGINNING (or SWT.TOP): Position the control at the top of the cell
• SWT.CENTER: Position the control in the vertical center of the cell
• SWT.END (or SWT.BOTTOM): Position the control at the bottom of the cell
• SWT.FILL: Resize the control to fill the cell vertically