OBJECT SET STYLE SHEET

4D v20 R7


OBJECT SET STYLE SHEET ( {* ;} objeto ; nomFolhaEstilo )

Parâmetro	Tipo	Descrição
*	Operador	Se especificado, objeto é um nome de objeto (cadeia) Se omitido, objeto é um campo ou uma variável
objeto	Objeto de formulário	Nome de objeto (se * for especificado) ou Campo ou variável (se * for omitido)
nomFolhaEstilo	Texto	Nome da folha de estilo

Descrição

O comando OBJECT SET STYLE SHEET modifica, para o processo atual, a folha de estilo associada ao objeto(s) designado(s) pelos parâmetros objeto e * . Uma folha de estilo modifica a fonte, o tamanho de fonte e o estilo de fonte.

Ao passar o parâmetro opcional * se indica que o parâmetro objeto é um nome de objeto (cadeia). Se não passar este parâmetro, indica que o parâmetro objeto é um campo ou uma variável. Neste caso, passa uma referência de campo ou variável no lugar de uma cadeia (campo ou variável objeto unicamente).

Passe no parâmetro nomFolhaEstilo, o nome da folha de estilo a aplicar ao objeto. Também pode passar:

O nome de uma folha de estilos existente (se a folha de estilo não existe, se devolve um erro, que pode interceptar utilizando um método instalado pelo comando ON ERR CALL).
Uma cadeia vazia ("") para não aplicar a folha destilo e ao objeto.

uma das constantes a seguir encontradas no tema "Estilos de fonte" para aplicar a folha de estilos automática:

Constante	Tipo	Valor	Comentário
Automatic style sheet	Cadeia	__automatic__	Usado como padrão para todos os objetos
Automatic style sheet_additional	Cadeia	__automatic_additional_text__	Suportado por texto estático, campos e variaáveis somente. Usado para texto adicional em caixas de diálogo
Automatic style sheet_main	Cadeia	__automatic_main_text__	Suportado apenas para texto estático, campos e variáveis. Usado para texto principal em caixas de diálogo.

Se uma folha de estilo já tinha sido associada ao objeto em modo Desenho, a chamada deste comando a substitui para o processo atual.

Se durante a sessão, utiliza os comandos ST SET ATTRIBUTES, ST SET TEXT ou OBJECT SET FONT, OBJECT SET FONT SIZE no objeto com o propósito de modificar sua fonte ou o tamanho de fonte, a referência a folha de estilos se apaga automaticamente do objeto - inclusive se atribui os mesmos atributos que os da folha de estilos. No entanto, se modificar o estilo (negrito, cursiva, etc.), por exemplo com os comandos ST SET ATTRIBUTES ou OBJECT SET FONT STYLE, se adicionam estas novas propriedades a folha de estilo pela duração da sessão.

Nota de compatibilidade

Em arquitetura de projeto, só as três folhas de estilo automáticas são compatíveis com esse comando

Ver também

Estilos de fonte
GET STYLE SHEET INFO
LIST OF STYLE SHEETS
OBJECT Get style sheet