Métodos IPaper
O StoServefornece objetos COPaper que são controlados principalmente por sua interface IPaper nativa.
A tabela a seguir lista os métodos IPaper do IPAPER. H no diretório irmão \INC.
| Método | Descrição |
|---|---|
| InitPaper | Inicializa o objeto de papel e cria uma matriz de dados de tinta. |
| Bloquear | Fornece ao cliente o controle do papel e bloqueia outros clientes. |
| Unlock | Abre mão do controle do cliente do papel. |
| Carregar | Carrega o conteúdo do papel do arquivo composto do cliente e notifica os coletores. |
| Salvar | Salva o conteúdo do papel no arquivo composto do cliente. |
| InkStart | Inicia o desenho de tinta colorida para a superfície de papel. |
| InkDraw | Coloca pontos de dados de tinta na superfície de papel eletrônico. |
| InkStop | Interrompe o desenho à tinta na superfície do papel. |
| Apagar | Apaga o conteúdo do papel atual e notifica os coletores. |
| Redimensionar | Redimensiona o tamanho do retângulo de papel de desenho e notifica os coletores. |
| Redesenhar | Redesenha o conteúdo do objeto de papel e notifica os coletores. |
Os métodos de interesse para este exemplo de código em arquivos compostos são Load, Save e Redraw.
InkStart, InkDraw e InkStop são métodos usados pelos clientes para comandar o COPaper para gravar sequências de desenho à tinta. O cliente normalmente responderá a uma mensagem WM_LBUTTONDOWN como o início de uma sequência de desenho à tinta chamando InkStart no COPaper. À medida que o usuário move o mouse ou a caneta para desenhar enquanto segura o botão esquerdo, o cliente responderá a mensagens repetidas WM_MOUSEMOVE com chamadas correspondentes para InkDraw. Quando o usuário liberar o botão esquerdo do mouse, o cliente responderá a uma mensagem WM_LBUTTONUP com uma chamada para InkStop, que marca o fim da sequência de desenho à tinta.
O InkStart informa ao COPaper a posição inicial da sequência de desenho nas coordenadas da janela do cliente. Ele também passa a cor e a largura da tinta selecionadas no momento. O cliente mantém essas seleções; COPaper apenas os registra quando a chamada InkStart é feita. InkDraw é chamado repetidamente para informar ao COPaper a sucessão de coordenadas de janela que representam o movimento de desenho do mouse ou caneta. O InkStop instrui o COPaper a marcar o fim de uma sequência de desenho.