Property editor/pt-br

Introdução
O editor de propriedades aparece quando a guia  da visão combinada está ativa na interface; ele permite gerenciar as propriedades publicamente expostas dos objetos de documento.

Geralmente, o editor de propriedade é destinado a lidar com apenas um objeto de cada vez. Os valores mostrados no editor de propriedade pertencem ao objeto selecionado do documento ativo. Apesar disso, algumas propriedades como cores, podem ser definidas para vários objetos selecionados. Se não houver elementos selecionados, o editor de propriedades estará vazio.

Nem todas as propriedades podem ser modificadas sempre; dependendo do status específico da propriedade, algumas delas serão invisíveis (não listadas), ou somente leitura (não editáveis).



Tipos de propriedade
Uma propriedade é uma informação como um número ou uma cadeia de texto que é anexada a um documento FreeCAD ou a um objeto no documento.

Objetos personalizados objetos com scripts podem usar qualquer um dos tipos de propriedade definidos no sistema base. Veja a lista completa em Propriedade.

Alguns dos tipos de propriedade mais comumente utilizados são:

Objetos diferentes podem ter diferentes tipos de propriedade. No entanto, muitos objetos têm os mesmos tipos porque são derivados da mesma classe interna. Por exemplo, a maioria dos objetos que descrevem formas geométricas (linhas, círculos, retângulos, sólidos, peças importadas, etc.) tem a propriedade "Colocação" que define sua posição na Vista 3D.

Propriedades de visualização e dados
Há duas classes de propriedades funcionais acessíveis através de abas no editor de propriedades:
 * Propriedades da as propriedades relacionadas à aparência "visual" do objeto. As propriedades de visualização estão ligadas ao atributo  do objeto e só são acessíveis quando a interface gráfica do usuário (GUI) é carregada. Eles não são acessíveis quando se usa o FreeCAD no modo de console ou como biblioteca sem cabeça.
 * Propriedades dos relativos aos parâmetros "físicos" do objeto. As propriedades dos definem as características essenciais do objeto; elas sempre existem, mesmo quando o FreeCAD é usado no modo console ou como uma biblioteca. Isto significa que se você carregar um documento em modo console, você pode alterar o raio de um círculo ou o comprimento de uma linha, mesmo que não consiga ver o resultado na tela.

Por esta razão, as propriedades dos são consideradas mais "importantes", uma vez que, na verdade, definem a geometria de uma forma. Por outro lado, as propriedades de são menos importantes porque afetam apenas a aparência da superfície da geometria. Por exemplo, um círculo com um raio de 10 mm é diferente de um círculo com um raio de 5 mm; a cor dos círculos (propriedade da aparência) não afeta sua forma, mas o raio (propriedade de dados). Em muitos casos, nesta documentação, a palavra "Propriedade" se refere a uma "propriedade de dados", não a uma "propriedade de aparência".

Propriedades básicas
O mais básico script de objeto não exibe nenhuma propriedade de  no editor de propriedade, exceto por seu atributo. O  é uma cadeia editável pelo usuário que identifica o objeto na vista em árvore. Por outro lado, o  de um objeto é um atributo interno que é atribuído ao objeto no momento de sua criação. Este atributo é somente de leitura, portanto não pode ser modificado, nem é exibido no editor de propriedade.

Um objeto paramétrico básico é criado da seguinte forma



A maioria dos objetos geométricos que podem ser criados e exibidos em Vista 3D são derivados de uma. Veja a Característica Part para conhecer as propriedades mais básicas desses objetos.

Para a geometria 2D, a maioria dos objetos são derivados de (ela mesma derivada de ) sendo a base dos Sketche, e elementos do  Draft. Veja a Part Part2DObject para as propriedades mais básicas destes objetos.

Ações
As ações na visão da propriedade foram implementadas em 0.19.

Clicar com o botão direito do mouse em um espaço vazio na vista ou com uma propriedade selecionada mostra apenas um comando:
 * se ativo, além das propriedades padrão que já aparecem, mostra todos os dados ocultos e exibe as propriedades nas respectivas abas.
 * Dados:"Proxy", "Label2", "Expression Engine", e "Visibility".
 * Vista:"Proxy".

When the option is active, and one property is selected, more actions are available with a second right click:
 * : deactivates the command, hiding the additional Data and View properties.
 * : adds a dynamic property to the object; this works with both C++ defined objects, and Python scripted objects.
 * : brings up the formula editor, which allows using expressions in the property value.
 * : if active, sets the property as hidden, meaning that it will only be displayed in the property editor if is active.
 * : if active, sets the property as output.
 * : if active, sets the property as not recomputed when the document is recomputed; this is useful when a property should be kept unaffected by other updates.
 * : if active, sets the property to be read-only; it won't be editable in the property editor any more until this switch is turned off. The menu entry is no longer available.  It may be still possible to change the property via a dialog that updates the property.
 * : if active, sets the property as transient. The value of a transient property is not saved to file. When opening a file, it is instantiated with its default value.
 * : if active, it becomes touched, and ready for recompute.
 * : if active, it is evaluated when the document is restored.

Exemplo de propriedades de um objeto PartDesign
In this section we show some common properties that are visible for a PartDesign Body, and one PartDesign Feature. The specific properties of an object can found in the specific documentation page of that object.

Vista
A maioria dessas propriedades são herdadas do objeto básico Part Feature.




 * : it is another way to specify how finely to generate the mesh for rendering on screen or when exporting. The default value is 28.5 degrees, or 0.5 radians. The smaller the value the smoother the appearance will be in the 3D view, and the finer the mesh that will be exported.
 * : indicates if a box showing the overall extent of the object is displayed.
 * : sets the accuracy of the polygonal representation of the model in the 3D view (tessellation). Lower values indicate better quality. The value is in percent of object's size.
 * : display mode of the entire Body, (default),, ,.
 * : display mode of the Tip of the Body, (default),.
 * :, , , ; defines the style of the edges in the 3D view.
 * :, (default).
 * : the RGB color of the edges, it defaults to.
 * : the thickness of the edges, it defaults to pixels.
 * : the RGB color of the vertices, it defaults to.
 * : the size of the vertices, it defaults to pixels.
 * : whether the object is selectable or not.
 * : the RGB color of the shape, it defaults to.
 * : if it is, the object appears in the tree view. Otherwise, it is set as invisible.
 * : the degree of transparency from (default) to.
 * : whether the object is visible in the 3D view or not. Toggle with the bar in the keyboard.
 * : the degree of transparency from (default) to.
 * : whether the object is visible in the 3D view or not. Toggle with the bar in the keyboard.

Data
Neste caso, observamos as propriedades da função Revolução PartDesign.




 * : the user defined name given to the object, this can be changed as desired.


 * : whether to refine the fusion done with other objects.


 * : the point in space that specifies where the revolution takes place. It cannot be modified directly, only when editing the feature.


 * : the axis around which the revolution will be performed. It cannot be modified directly, only when editing the feature.


 * : the angle that specifies how much of the base element is rotated. By default it is, but it can be any fraction of that.


 * : if the base object is a Sketch, when this property is, it will perform the revolution with the sketch serving as a plane of symmetry. This is noticeable if the is different from.
 * : by default it is . Whether to perform the revolution in one direction or the other.

Scripting
FreeCAD Scripting Basics.

See scripted objects for the full information on adding properties to objects defined through Python.

Most properties that are visible in the property editor can be accessed from the Python console. These properties are just attributes of the class that defines the selected object. For example, if the property editor shows the property, this means that the object has the  attribute.

These attributes (properties) are added with the method of the base object. At least it is necessary to specify the type of property, and its name.

Properties follow the or  convention, meaning that each word starts with a capital letter, and there are no underscores. When the property editor displays such names, it leaves a space between each capital letter, making it easier to read.



In similar way the properties are added, not to the base object, but to its. Then, it follows that properties like, , , , , and others, can be examined and changed from the Python console.

Todas as propriedades públicas do objeto e seu provedor de visão estão contidas no atributo correspondente.