Métodos CGuiPaper
Os métodos de CGuiPaper são resumidos da seguinte maneira. Todos esses métodos são implementados no GUIPAPER. CPP.
| Método | Descrição |
|---|---|
| BOOL Init(HINSTANCE hInst, HWND hWnd, TCHAR* pszCmdLineFile); | Inicializa o GuiPaper. Solicita que o servidor crie um objeto COPaper. |
| HRESULT DrawOn(void); | Bloqueia papel para desenhar exclusivamente por este cliente. |
| HRESULT DrawOff(void); | Desbloqueia papel para permitir que outros clientes desenhem. |
| HRESULT ClearWin(void); | Limpa a janela de exibição, mas retém dados de tinta. |
| HRESULT PaintWin(void); | Limpa janela e repinta com os dados de tinta atuais. |
| HRESULT Erase(void); | Apaga o conteúdo do desenho atual e limpa a janela de exibição. |
| HRESULT Resize(WORD wWidth, WORD wHeight); | Redimensiona a janela de exibição. |
| HRESULT InkWidth(SHORT nInkWidth); | Define a largura atual da tinta para desenho. |
| HRESULT InkColor(COLORREF crInkColor); | Define a cor da tinta atual para desenho. |
| HRESULT InkSaving(BOOL bInkSaving); | Ativa e desativa o salvamento de dados à tinta no COPaper. |
| HRESULT InkStart(SHORT nX, SHORT nY); | Inicia a sequência de desenho à tinta. |
| HRESULT InkDraw(SHORT nX, SHORT nY); | Desenha dados de sequência de tinta. |
| HRESULT InkStop(SHORT nX, SHORT nY); | Interrompe a sequência de desenho à tinta. |
| HRESULT ConnectPaperSink(void); | Conecta o objeto PaperSink do cliente à origem do COPaper do servidor. |
| HRESULT DisconnectPaperSink(void); | Desconecte o objeto PaperSink do cliente da origem do COPaper do servidor. |
| HRESULT Load(void); | Carrega dados de tinta do arquivo composto atual. |
| HRESULT Save(void); | Salva dados de tinta existentes no arquivo composto atual. |
| HRESULT AskSave(void); | Verifica se o desenho foi alterado. Nesse caso, exibe a caixa de diálogo perguntando ao usuário se deseja salvar as alterações e responde adequadamente. |
| HRESULT Open(void); | Mostra a caixa de diálogo comum do Win32. Abre o arquivo composto de dados de papel existente. |
| HRESULT SaveAs(void); | Mostra a caixa de diálogo comum do Win32. Salva dados de papel atuais no arquivo renomeado. |
| COLORREF PickColor(void); | Mostra a caixa de diálogo ommon do Win32. Solicita que o usuário escolha a nova cor da caneta. |
O método Init cria o objeto COPaper baseado em servidor e atribui o membro m_pIPaper do CGuiPaper.
Os métodos AskSave, Open, SaveAs e PickColor fornecem um comportamento de GUI familiar usando caixas de diálogo comuns do Win32. Por exemplo, o método Open usa a caixa de diálogo Nome de Arquivo Aberto do Win32 para solicitar que o usuário especifique um nome de arquivo para abertura.
Os métodos Load e Save serão abordados em detalhes mais adiante neste tour.
InkSaving, InkStart, InkDraw e InkStop são os métodos centrais para a funcionalidade de desenho do aplicativo StoClien . O StoClien usa esses métodos CGuiPaper para capturar, exibir e armazenar os dados de desenho interativos conforme eles ocorrem sob controle do usuário. Eles executam uma função dupla de pintar a imagem desenhada para a janela do cliente, bem como passar os dados de desenho para COPaper no servidor. O COPaper converte os dados de desenho em pacotes de dados de tinta para armazenamento.