Set Attributes extension - Revision history

Michaudm at 17:57, 23 May 2015

2015-05-23T17:57:03Z

Michaudm at 17:54, 23 May 2015

2015-05-23T17:54:50Z

Michaudm at 17:44, 23 May 2015

2015-05-23T17:44:42Z

Michaudm at 17:39, 23 May 2015

2015-05-23T17:39:37Z

Michaudm at 17:39, 23 May 2015

2015-05-23T17:39:13Z

Michaudm at 06:36, 12 May 2015

2015-05-12T06:36:41Z

Michaudm at 22:04, 11 May 2015

2015-05-11T22:04:30Z

Michaudm at 22:00, 11 May 2015

2015-05-11T22:00:56Z

Michaudm: /* What is this extension for ? */

2015-05-11T22:00:09Z

What is this extension for ?

Michaudm at 21:59, 11 May 2015

2015-05-11T21:59:22Z

← Older revision		Revision as of 17:57, 23 May 2015
Line 34:		Line 34:

	* '''iconHeight''' : height of icons or buttons containing text (default is 32)		* '''iconHeight''' : height of icons or buttons containing text (default is 32)
		+
		+	* '''unselect''' : unselect selected features after every use of SetAttributes

	Note 1 : all buttons have the same size.		Note 1 : all buttons have the same size.

@@ Line 50: / Line 50: @@
 A button can contain an image (jpg, png or gif images are supported) or a text.
-* '''icon''' : if an image with the name of the attribute icon can be loaded, this image is displayed in the button. Else, the text of the attribute '''text''' is displayed.
+* '''icon''' : if an image with the name of the attribute icon can be loaded, this image is displayed in the button. Else, the text of the attribute '''text''' is displayed. It accepts 0xFFFFFF or #FFFFFF syntax.
 * '''text''' : the text displayed on the button if no icon is set or if the icon is not found. You may need to set a larger iconWidth in setAttributesToolbox element to display the text.

@@ Line 54: / Line 54: @@
 * '''text''' : the text displayed on the button if no icon is set or if the icon is not found. You may need to set a larger iconWidth in setAttributesToolbox element to display the text.
-* '''backgroundColor''' : this optional attribute can be used to set the background color of the button if no icon is defined.
+* '''backgroundColor''' : this optional attribute can be used to set the background color of the button if no icon is defined. Note that the backgroundColor may color the background of the button or the border of the button depending on the selected look and field.
 * '''atomic''' : a special (optional) attribute to define how the tool behaves if some attributes defined by the button can't be found.

@@ Line 7: / Line 7: @@
 Selected features must be '''editable'''.
 '''Tooltip''' : if you place your mouse above a button, you may get a small tooltip with the complete name of the button or a small explanation.
 '''Advanced Tooltip''' : if you click on the right mouse button, you get a rich tooltip with the details of button parameters.

@@ Line 7: / Line 7: @@
 Selected features must be '''editable'''.
 == How does it work ? ==
@@ Line 46: / Line 49: @@
 * '''icon''' : if an image with the name of the attribute icon can be loaded, this image is displayed in the button. Else, the text of the attribute '''text''' is displayed.
 * '''atomic''' : a special (optional) attribute to define how the tool behaves if some attributes defined by the button can't be found.

@@ Line 2: / Line 2: @@
 == What is this extension for ? ==
-[[File:SetAttributes.png|left|240px|caption]] You are editing or updating a dataset with complex features having many attributes. Some of these attributes can take a limited number of values (ex. type of a building, maxspeed of a road, type of vegetation...). Some attributes may be related to each others (ex. roads of type highway can have maxspeed of 110 or 130 while major roads are limited to 60, 70 or 90, and maxspeed must be empty for pedestrian paths).
+[[File:SetAttributes.png|left|240px|caption]] You are editing or updating a dataset with features having many attributes. Some of these attributes can take a restricted set of values (ex. type of a building, maxspeed of a road, type of vegetation...). They may also be related to each others (ex. roads of type highway can have maxspeed of 110 or 130 while major roads are limited to 60, 70 or 90, and maxspeed must be empty for pedestrian paths).
 Set attributes makes it possible to create a toolbox with buttons which will set one or many attributes in one go with a set of predefined values. When you press the button, attributes of all selected features are set to the desired value(s).
@@ Line 48: / Line 48: @@
 * '''atomic''' : a special (optional) attribute to define how the tool behaves if some attributes defined by the button can't be found.
+**If atomic is omitted or set to false, the tool will set as many attributes as it can, even if some attributes are not found.
-If atomic is omitted or set to false, the tool will set as many attributes as it can, even if some attributes are not found.
+**If atomic is set to true, the tool will abandon the modification if it fails to set a single attribute.
 * '''layer''' : The next (optional) attribute makes it possible to target a specific or several specific layers. This attributes understand
@@ Line 58: / Line 56: @@
 ** a regex if the name is written between / (ex. layer="/major roads|minor roads/")
 Note that to match '''any''' layer, you can omit this attribute or set it to "*".
 * '''tooltip''' : an optional attribute to set well.... a tooltip on the button.
@@ Line 70: / Line 70: @@
 === The '''attribute''' element ===
-Last element is the simplest. It has only two attributes :
+Last element is the simplest. It may have three attributes :
-* '''name''' : the name of the attribute to set
+* '''name''' : the name of the attribute to set. This attribute is mandatory.
-* '''value''' : the new value for this attribute
+* '''value''' : the new value for this attribute. This attribute is optional. If you omit the value attribute, the attribute will be set to null.
 You can associate as many attributes as you want to one button.
-If you omit the value attribute, the attribute will be set to null.
 Let's put it all together :
@@ Line 86: / Line 91: @@
      </button>
   </setAttributesToolbox>