Histórico da Página

TSrvObject

...

cClasse

(caracter)

Retorna o nome da classe.

oObject:ClassName()   // Result: "TButton"

CoorsUpdate

Atualiza o posicionamento (vertical superior, horizontal esquerda, vertical inferior e horizontal direita) do objeto.

TSrvObject(): CoorsUpdate ( ) -->

oObject:CoorsUpdate()

Disable

Desabilita o objeto.

TSrvObject(): Disable ( ) -->

oObject:Disable()

Enable

Habilita o objeto.

TSrvObject(): Enable ( ) -->

oObject:Enable()

FreeChildren

Elimina/Libera todos os objetos da classe onde este método é chamado.

TSrvObject(): FreeChildren ( ) -->

oObject:FreeChildren()

GetClientRect

Retorna as coordenadas de posicionamento e dimensão (vertical superior, horizontal à esquerda, vertical inferior e horizontal à direita) do objeto.

TSrvObject(): GetClientRect ( ) --> aCoords

aCoords

()

Retorna um array com as coordenadas de posicionamento e dimensão (vertical superior, horizontal esquerda, vertical inferior e horizontal direita) do objeto.

O retorno é o valor real do objeto criado, que na verdade é diferente do parâmetro da criação. Isso porque o sistema sempre duplica os valores passados no momento da criação.

oObject:GetClientRect()   // Result: {10,10,240,340}

Métodos

Inclusão de trecho

	Classe TSrvObject - Métodos
	Classe TSrvObject - Métodos
nopanel	true

Observações

Esta classe não pode ser instanciada diretamente.

Propriedades

GetFont

Retorna a fonte do objeto.

TSrvObject(): GetFont ( ) --> oFont

oFont

()

Retorna o objeto do tipo TFont utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual.

oObject:GetFont()

GetText

Retorna o título do objeto contido na propriedade cCaption.

TSrvObject(): GetText ( ) --> cCaption

cCaption

(caracter)

Retorna o título do objeto.

oObject:GetText()

Hide

Torna o objeto invisível.

TSrvObject(): Hide ( ) -->

oObject:Hide()

hWHandle

Retorna o handle do objeto.

TSrvObject(): hWHandle ( ) --> nHdl

nHdl

()

Retorna o handle do objeto.

oObject:hWHandle()   // Result: 3001

lCanGotFocus

Define se o objeto pode ou não receber foco.

TSrvObject(): lCanGotFocus ( < lFoco> ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
lFoco	Lógico	Indica se, verdadeiro (.T.), o objeto pode receber foco; caso contrário, falso (.F.).	X

oBtn:lCanGotFocus := .T.

Move

Move o objeto.

TSrvObject(): Move ( [ nTop], [ nLeft], [ nWidth], [ nHeight], [ uParam5], [ lRealCoords] ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
nTop	Numérico	Indica a posição ao topo.
nLeft	Numérico	Indica a posição à esquerda.
nWidth	Numérico	Indica a largura do objeto.
nHeight	Numérico	Indica a altura do objeto.
uParam5	Qualquer	Compatibilidade
lRealCoords	Lógico	Indica se as bordas do objeto serão consideradas no cálculo de movimentação.

oObject:Move(oObject:nTop,oObject:nLeft,498,250,,.T.)

Owner

Retorna o objeto do tipo tWindow ou tDialog utilizado na criação desta classe.

TSrvObject(): Owner ( ) --> xObjeto

xObjeto

()

Retorna o objeto do tipo tWindow ou tDialog onde este foi criado.

oObject:Owner()

Refresh

Atualiza as propriedades do objeto no TOTVS Smart Client.

TSrvObject(): Refresh ( ) -->

oObject:Refresh()

SaveAsBMP

Salva uma cópia do objeto no formato Bitmap (*.BMP).

TSrvObject(): SaveAsBMP ( ) --> lOk

lOk

(logico)

Retorna verdadeiro (.T.), se a imagem for salva com sucesso; caso contrário, retorna falso (.F.).

oObject:SaveAsBMP("c:\Dir\Imagem.BMP")

SetColor

Define as cores do objeto.

TSrvObject(): SetColor ( [ nClrFore], [ nClrBack] ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
nClrFore	Numérico	Indica a cor da fonte.
nClrBack	Numérico	Indica a cor de fundo do objeto.

oObject:SetColor(CLR_BLACK,CLR_WHITE)

SetCoors

Define as coordenadas (à esquerda, ao topo, largura e altura) do objeto utilizando a classe TRect.

TSrvObject(): SetCoors ( < oRect> ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
oRect	Objeto	Indica o objeto do tipo TRect é utilizado para definir as coordenadas.	X

Para mais informações sobre a parametrização, consulte a documentação da classe TRect.

oRect := TRect():New(32,2,100,100)oObject:SetCoors(oRect)

SetCSS

...

Sintaxe

Bloco de código
TSrvObject(): SetCSS ( < cCssText> ) --> Nil

Parâmetros/Elementos

Nome	Tipo	Descrição	Obrigatório	Referência
cCSS	Caracter	Indica o texto com formato CSS para o objeto.	X

Retorno

Nil (Nulo)

Observações

O guia de estilo é de propriedade da Qt Company, e pode ser consultado no link: http://qt-project.org/doc/qt-4.8/stylesheet-examples.html.

Para a aplicação do estilo é necessário associar o componente ADVPL ao seu equivalente Qt, conforme tabela abaixo:

Exemplo

Bloco de código

theme	Eclipse
language	cpp
linenumbers	true
collapse	false

oButton1 := TButton():New( 002, 002, "Botão 01",oDlg,{|| alert("Botão 01") }, 40,10,,,.F.,.T.,.F.,,.F.,,,.F. )    
oButton1:SetCss("QPushButton:pressed { background-color: qlineargradient(x1: 0, y1: 0, x2: 0, y2: 1, stop: 0 #dadbde, stop: 1 #f6f7fa); }")

Tabela de componentes (DePara). Válida para SmartClient 131227A ou superior.

Componente ADVPL	Equivalente Qt
TButton SButton TBrowseButton TBtnBmp TBtnBmp2 THButton	QPushButton
TCBrowse BrGetDDb MsBrGetDBase MsSelBr TSBrowse TWBrowse VCBrowse	QTableWidget
TCColumn	QTableWidgetItem
TCheckBox	QCheckBox
TComboBox	QComboBox
TFolder	QTabBar
TGet	QLineEdit
TGrid	QTableView
TGroup	QGroupBox
TListBox	QListWidget
TMeter	QProgressBar
TMsgBar	QStatusBar
TMsgItem	QLabel
TMultiGet	QTextEdit
TPanel	QLabel
TRadMenu	QRadioButton
TSay	QLabel
TScrollArea TScrollBox	QScrollArea
TSimpleEditor	QTextEdit
TSlider	QSlider
TSpinBox	QSpinBox
TSplitter	QSplitter
TToolBox	QToolBox
TTree	QTreeWidget

SetDisable

Habilita ou desabilita o objeto.

TSrvObject(): SetDisable ( < lEnable> ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
lEnable	Lógico	Indica se o habilita (.T.) ou desabilita (.F.) o objeto.	X

oObject:SetDisable(.T.)

SetEnable

Habilita ou desabilita o objeto.

TSrvObject(): SetEnable ( < lEnable> ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
lEnable	Lógico	Indica se o habilita (.T.) ou desabilita (.F.) o objeto.	X

oObject:SetEnable(.F.)

SetFocus

Altera o foco da entrada de dados para o objeto.

TSrvObject(): SetFocus ( ) -->

oObject:SetFocus()

SetFont

Define a fonte do objeto.

TSrvObject(): SetFont ( < oFont> ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
oFont	Objeto	Indica o objeto do tipo TFont utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual.	X

oFont := TFont():New('Courier new',,-16,.T.)oObject:SetFont( oFont )

SetProperty

Permite alterar o valor de qualquer propriedade do objeto.

TSrvObject(): SetProperty ( < cProp>, < xValue> ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
cProp	Caracter	Indica o nome da propriedade do objeto.	X
xValue	Qualquer	Indica o valor que será atribuído à propriedade.	X

oObject:SetProperty( "cName", novoValor )

SetText

Define o texto do objeto.

TSrvObject(): SetText ( < cTexto> ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
cTexto	Caracter	Indica o texto do objeto.	X

oObject:SetText("texto")

SetUpdatesEnabled

Habilita ou desabilita a atualização do objeto.

TSrvObject(): SetUpdatesEnabled ( [ lEnable] ) -->

Nome	Tipo	Descrição	Obrigatório	Referência
lEnable	Lógico	Indica se habilita (.T.) ou desabilita (.F.) a atualização do objeto.

Utilize esse método quando um determinado conjunto de operações são necessárias mas a visualização de seus passos não.

Exemplo:

É necessário adicionar 20 itens num objeto do tipo Browse e a visualização da inserção não é relevante ao processo.

// Desabilita a atualizaçãooObject:SetUpdatesEnabled( .F. )for nX := 1 to  20 ... insere// Habilita a atualizaçãooObject:SetUpdatesEnabled( .T. )

oObject:SetUpdatesEnabled( .F. )

Show

Torna o objeto visível.

TSrvObject(): Show ( ) -->

oObject:Show()

Propriedade

Propriedade	Descrição	Tipo
aControls	Indica o array de objetos criados nesta classe.	Vetor
bGotFocus	Indica o bloco de código que será executado quando o objeto ganha foco.	Bloco de código
bHelp	Indica o bloco de código que será executado ao pressionar F1 quando o foco estiver no objeto.	Bloco de código
bLClicked	Indica o bloco de código que será executado quando clicar, com o botão esquerdo do mouse, sobre o objeto.	Bloco de código
bLDblClick	Indica o bloco de código que será executado quando clicar duas vezes, com o botão esquerdo do mouse, sobre o objeto.	Bloco de código
bLostFocus	Indica o bloco de código que será executado quando o objeto perde foco.	Bloco de código
bRClicked	Indica o bloco de código que será executado quando clicar, com o botão direito do mouse, sobre o objeto.	Bloco de código
bValid	Indica o bloco de código de validação que será executado quando o conteúdo do objeto for modificado. Retorna verdadeiro (.T.), se o conteúdo é válido; caso contrário, </tr> <tr> falso (.F.).	Bloco de código
bWhen	Indica o bloco de código que será executado quando a mudança de foco da entrada de dados, no objeto criado, estiver sendo realizada. Se o retorno for verdadeiro (.T.), o </tr> <tr> objeto continua habilitado; caso contrário, falso (.F.).	Bloco de código
cCaption	Indica o título ou conteúdo do objeto.	Caracter
cMsg	Indica a mensagem que será apresentada na barra de status, da janela principal, quando o objeto ganha foco.	Caracter
cName	Indica o nome do objeto.	Caracter
cReadVar	Indica o conteúdo da variável atribuída internamente ao objeto.	Caracter
cTooltip	Indica a mensagem que será apresentada quando o objeto exibir sua dica de contexto (tooltip).	Caracter
lActive	Indica se o objeto está (.T.) ou não (.F.) ativo.	Lógico
lCanGotFocus	Indica se objeto pode (.T.) ou não (.F.) receber foco.	Lógico
lVisible	Indica se o objeto é visível (.T.) ou invisível (.F.).	Lógico

...

nBottom	Indica a altura em pixels.	Numérico
nClientHeight	Indica a altura em pixels.	Numérico
nClientWidth	Indica a largura em pixels.	Numérico
nClrPane	Indica a cor de fundo do objeto.	Numérico
nClrText	Indica a cor do texto do objeto.	Numérico
nHeight	Indica a altura em pixels do objeto.	Numérico
nLeft	Indica a coordenada horizontal em pixels.	Numérico
nRight	Indica a largura em pixels.	Numérico
nTop	Indica a coordenada vertical em pixels.	Numérico
nWidth	Indica a largura em pixels do objeto.	Numérico
nWnd	Indica o manipulador (Handle) do objeto.	Numérico
oCargo	Indica o conteúdo associado ao objeto.	Objeto
oCursor	Indica o tipo de ponteiro do mouse.	Objeto
oFont	Indica o objeto do tipo TFont utilizado para definir as características da fonte aplicada na exibição do conteúdo do controle visual.	Objeto
oParent	Indica a janela ou controle visual onde o objeto será criado.	Objeto
oWnd	Indica o objeto do tipo tDialog ou tWindow onde se encontra este objeto.

...

Esta propriedade é utilizada apenas para consulta. Qualquer atribuição feita programaticamente nesta propriedade com um objeto de interface válido é ignorada, e qualquer atribuição de objeto inválido ( não pertencente à hierarquia de tDialog ou tWindow ) vai gerar uma ocorrência de erro fatal Advpl "Invalid class type passed to method or property!".

Objeto

...