Bug 52730 [Dialogs] TitleAreaDialog wrong doc for createDialogArea
/** * Creates and returns the contents of the upper part * of this dialog (above the button bar). * <p> * The <code>Dialog</code> implementation of this framework method * creates and returns a new <code>Composite</code> with * standard margins and spacing. Subclasses should override. * </p> * * @param the parent composite to contain the dialog area * @return the dialog area control */ protected Control createDialogArea(Composite parent) @@@@ The composite created by this method does _not_ have standard margings and spacing but 0-width margins and spacing.
bundles/org.eclipse.jface/src/org/eclipse/jface/dialogs/TitleAreaDialog.java
* Creates the dialog's title area.
 *
 * @param parent the SWT parent for the title area widgets
 * @return Control with the highest x axis value.
 */
private Control createTitleArea(Composite parent) {
		
	
	parent.addDisposeListener(new DisposeListener() {
		public void widgetDisposed(DisposeEvent e) {
			if (titleAreaColor != null)
				titleAreaColor.dispose();
		}
	});
	
	
	Display display = parent.getDisplay();
	Color background;
	Color foreground;
	if (titleAreaRGB != null) {
		titleAreaColor = new Color(display, titleAreaRGB);
		background = titleAreaColor;
		foreground = null;
	} else {
		background = JFaceColors.getBannerBackground(display);
		foreground = JFaceColors.getBannerForeground(display);
	}	
	int verticalSpacing = convertVerticalDLUsToPixels(IDialogConstants.VERTICAL_SPACING);
	int horizontalSpacing = convertHorizontalDLUsToPixels(IDialogConstants.HORIZONTAL_SPACING);
	parent.setBackground(background);