# cPropertyTab

###### Identifier:

org.eclipse.cdt.ui.cPropertyTab

###### Since:

4.0

###### Description:

Implementation of property/preference UI element. There're 2 ways to display property/preference data: either on pages with tabs, or on simple pages. In first case, each cPropertyTab extending class represents single tab in tabfolder. In second case, cPropertyTab extending class represents whole page contents (except header elements which are common for all pages). Note that cPropertyTab extending class ("tabs" below) do not distinguish these 2 cases, moreover, they may be shown both in multi-tab and single-tab mode. It's up to page to select displaying mode. In multi-tab page, tabs are displayed in order defined by their weights.

###### Configuration Markup:

<!ELEMENT extension (tab+)>

<!ATTLIST extension

point CDATA #REQUIRED

id CDATA #IMPLIED

name CDATA #IMPLIED>

<!ELEMENT tab EMPTY>

<!ATTLIST tab

icon CDATA #IMPLIED

class CDATA #REQUIRED

name CDATA #REQUIRED

parent CDATA #REQUIRED

tooltip CDATA #IMPLIED

weight CDATA #IMPLIED

helpId IDREF #IMPLIED>

- icon - Icon to be displayed for corresponding tab in tabfolder. Ignored for single-tab pages
- class - Class implementing org.eclipse.cdt.ui.newui.ICPropertyTab
- name - Name of tab in tabfolder. Ignored for single-tab pages.
- parent - Class name for container page. Usually pages are to be derived from org.eclipse.cdt.ui.newui.AbstractPage, but it is not obligatory.
- tooltip - Text of tooltip shown over the tab.
- weight - Abstract value to be used for sorting tabs inside of tab folder. Ignored for single-tab page.
- helpId - Help context Id for given tab.

###### Examples:

###### API Information:

Tabs must implement interface: org.eclipse.cdt.managedbuilder.ui.newproperties.ICPropertyTab

###### Supplied Implementation:

Implementors in org.eclipse.cdt.ui.newui: BinaryParsTab CLocationOutputTab CLocationSourceTab CLocationTab EnvironmentTab ErrorParsTab ExpIncludeTab ExpLibraryPathTab ExpLibraryTab ExpSymbolTab ICPropertyTab IncludeTab LanguagesTab LibraryPathTab LibraryTab RefsTab SDKsTab SymbolTab Implementors in org.eclipse.cdt.managedbuilder.ui.newui: ArtifactTab BuilderSettingsTab BuildStepsTab CBuildLocationOutputTab CPropertyVarsTab DiscoveryTab ToolChainEditTab ToolSettingsTab

Copyright (c) 2007 Intel Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html Contributors: Intel Corporation - initial API and implementation