Sancho: Основной текст

2011-09-02T16:14:06Z

Основной текст

New page

<section begin=title /><noinclude>{{DISPLAYTITLE:</noinclude>Styles and Templates<noinclude>}}</noinclude><section end=title />{{BreadCrumbL10n}}

{{Documentation/BASICGuideTOC
|ShowPrevNext=block
|ShowPrevPage=block
|PrevPage=EN/documentation/basic_guide/stardesktop
|NextPage=EN/documentation/basic_guide/text_documents
|docs=block
}}

__NOTOC__

==Styles==

Styles are named lists containing formatting attributes. They work in all applications of {{OOo}} and help to significantly simplify formatting. If the user changes one of the attributes of a style, then {{OOo}} automatically adjusts all document sections depending on the attribute. The user can therefore, for example, change the font type of all level one headers by means of a central modification in the document.

=== Style Types ===

Depending on the relevant document types, {{OOo}} recognizes a whole range of different types of styles.

{{OOo}} Writer supports the following types of styles:

* Character styles
* Paragraph styles
* Frame styles
* Page styles
* Numbering styles

{{OOo}} Calc supports the following types of styles:

* Cell styles
* Page styles

{{OOo}} Impress supports the following types of styles:

* Character element styles
* Presentation styles

In {{OOo}} terminology, the different types of styles are called <tt>StyleFamilies</tt> in accordance with the <idl>com.sun.star.style.StyleFamily</idl> service on which they are based. The <tt>StyleFamilies</tt> are accessed by means of the document object:

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object
Dim CellStyles As Object

Doc = ThisComponent
StyleFamilies = Doc.StyleFamilies
CellStyles = StyleFamilies.getByName("CellStyles")
</source>

The example uses the <tt>StyleFamilies</tt> property of a spreadsheet document to establish a list containing all available cell styles.

The individual styles can be accessed directly by means of an index:

<source lang="oobas">
Dim Doc As Object
Dim Sheet As Object
Dim StyleFamilies As Object
Dim CellStyles As Object
Dim CellStyle As Object
Dim I As Integer

Doc = ThisComponent
StyleFamilies = Doc.StyleFamilies
CellStyles = StyleFamilies.getByName("CellStyles")

For I = 0 To CellStyles.Count - 1
CellStyle = CellStyles(I)
MsgBox CellStyle.Name
Next I
</source>

The loop added since the previous example displays the names of all cell styles one after another in a message box.
{{Note|The reference <tt>CellStyles(I)</tt> corresponds to the method <tt>getByIndex()</tt>, which is optional for these style container objects. It may not be available in all types of documents.
The method <tt>getByName()</tt> is mandatory, and should always be available.}}

=== Details about various formatting options ===

Each type of style provides a whole range of individual formatting properties. Here is an overview of the most important formatting properties and the points at which they are explained:

* [[EN/documentation/basic_guide/structure_of_text_documents#Character Properties|Character properties]], <idl>com.sun.star.style.CharacterProperties</idl> service
* [[EN/documentation/basic_guide/structure_of_text_documents#Paragraph Properties|Paragraph properties]], <idl>com.sun.star.text.Paragraph</idl> service
* [[EN/documentation/basic_guide/formatting_spreadsheet_documents#Cell Properties|Cell properties]], <idl>com.sun.star.table.CellProperties</idl> service
* [[EN/documentation/basic_guide/formatting_spreadsheet_documents#Page Properties|Page properties]], <idl>com.sun.star.style.PageProperties</idl> service
* [[EN/documentation/basic_guide/formatting_spreadsheet_documents|Character element properties]], Various services

The format properties are by no means restricted to the applications in which these are explained, but instead can be used universally. For example, most of the page properties described in [[EN/documentation/basic_guide/spreadsheets|Spreadsheets]] can therefore be used not only in {{OOo}} Calc, but also in {{OOo}} Writer.

More information about working with styles can be found in the [[EN/documentation/basic_guide/structure_of_text_documents#Default values for character and paragraph properties|'''Default values for character and paragraph properties''']] section in [[EN/documentation/basic_guide/text_documents|Text Documents]].

==Templates==

Templates are auxiliary documents. They provide a very convenient way to store, maintain, and distribute styles, macros, boiler-plate text, and other useful things.

===Document and Template Types===

Each major type of {{OOo}} document has its own associated template type. In general, and for styles in particular, you can access information within a template in the same way you would access the same information in the associated document type. In other words, code (like the above examples) that works in a particular document type should also work for the associated template type.

===Automatic Update===

Most template types – Draw templates are the exception – have an automatic-update feature. If a style in the template has been changed, and you open a document created with that template, you will see a message asking whether to update the styles in the document. If you click on '''Yes''', the new or changed styles will be copied into the document. Styles deleted from the template are not removed from documents.

A problem may arise if you click on '''No''': the styles will not be updated, and the automatic-update feature will be turned off. As of {{OOo}} Version 3.1, this status does not show in the GUI, nor is there any GUI way to re-enable the feature. (For Writer documents only, you can use the [http://extensions.services.openoffice.org/project/templatechanger Template Changer extension] to set this feature again.)

The following subroutine, adapted from the Template Changer extension, will re-enable the update feature for all document types.
<source lang="oobas">
Sub FixUpdate
Dim oDocSettings as Object
oDocSettings = ThisComponent.createInstance( "com.sun.star.document.Settings" )
oDocSettings.UpdateFromTemplate = True
End Sub 'FixUpdate
</source>

{{PDL1}}

EN/documentation/basic guide/templates - Revision history

Sancho: Основной текст