Przy użyciu formantu RSClientPrint aplikacje niestandardowe
The Microsoft ActiveX control, RSPrintClient, provides klient-side printing for reports viewed in przeglądarka HTML.Zapewnia on Drukowanie , okno dialogowe, dzięki czemu użytkownik może zainicjować zadanie drukowania, wyświetlanie podglądu raportu, określić strony do drukowania i zmienić ustawienia marginesów.Podczas operacji drukowania po stronie klient, serwer raportów renderowania raportów w obraz (EMF) rozszerzenie renderujące i używa możliwości drukowania systemu operacyjnego, aby utworzyć zadanie drukowania i wysłać go do drukarki.
Drukowanie po stronie klient umożliwia kontrolowanie i poprawić jakość wydruku dla raportu HTML za pomocą przeglądania strona ustawień drukowania przeglądarki na użytkownika komputera, a zamiast nich wymiary strona, marginesów, nagłówków i tekstu stopki raportu tworzenie przy użyciu drukowania danych wyjściowych.Formant drukowania odczytuje wartości właściwość raportu, aby zestaw strona, rozmiar i marginesy.
Deweloperzy, który chcesz włączyć funkcję drukowania po stronie klient, paski narzędzi innych firm lub przeglądarki mogą uzyskać dostęp za pośrednictwem formantu ActiveX RSClientPrint Obiekt COM.Formant może zostać rozłożone swobodnie.Poniższa lista zawiera zalecenia dotyczące korzystania z formantu:
Formant używany do poprawy drukowania w przypadku raportów opartych na sieci Web.You can specify the object in any of the Microsoft .NET Framework-compatible programming languages or in script.Formant nie jest przeznaczony do Microsoft Aplikacje Windows Forms.
Kopiowanie pliku .cab z Reporting Services pliki programów i dodać go do podstawowej kodu aplikacji niestandardowych.
Użycie <OBIEKT> znacznik, aby określić formant.
Określ adres URL względny lub w pełni kwalifikowana do pliku .cab w atrybucie OBJECT CODEBASE.
Określić własne informacje o wersji aplikacji dla pliku .cab do śledzenia, która wersja jest używany w aplikacji.
Przegląd dokumentacji Books Online tematy dotyczące renderowania obrazów (EMF) zrozumienie sposobu renderowania stron na podglądzie wydruku i dane wyjściowe.
Przegląd RSPrintClient
Formant wyświetla niestandardowe okno dialogowe drukowania, które obsługuje takie same funkcje jak inne okna dialogowe drukowania, w tym podgląd wydruku, możliwość wybrania określonych stron i zakresów stron, marginesy i orientację strony.Formant jest dostarczana w pliku CAB.Tekst w Drukowanie , okno dialogowe jest zlokalizowany na wszystkie języki obsługiwane w SQL Server. RSPrintClient Formant ActiveX używa rozszerzeń renderowania obrazów (EMF) w celu wydrukowania raportu.Poniższe informacje urządzenia EMF są używane: StartPage EndPage, MarginBottom, MarginLeft, MarginTop, MarginRight, PageHeight i PageWidth. Inne urządzenia ustawienia informacji dla renderowania obrazów nie są obsługiwane.
Obsługa języka
Formant drukowania zawiera tekst interfejs użytkownika w różnych językach i akceptuje wartości wejściowych skalibrowany miary w różnych systemach.System języka i miary używane są określone przez Kultura and UICulture właściwości.Obie właściwości akceptuje wartości LCID.Po określeniu identyfikatora LCID dla języka, który jest zmiana w obsługiwanym językiem uzyskasz, język, który zapewnia najlepsze dopasowanie.Po określeniu identyfikatora LCID, który nie jest obsługiwany i dla których nie identyfikator LCID jest zbliżona uzyskasz, angielski (Stany Zjednoczone).
W polu kod przy użyciu RSPrintClient
The RSClientPrint object is used to gain access programmatically to the ActiveX control and its methods and properties.Formant zawiera modalnego okna dialogowego Podgląd wydruku.
Określanie wartości domyślnych
Który umożliwia zainicjowanie Drukowanie okno dialogowe z wartościami strona i marginesów raportu.Domyślnie Drukowanie , okno dialogowe jest inicjowany z wartościami z definicja raportu.Użyj ustawień domyślnych lub określić różne wartości przez ustawienie właściwości obiektu.
Wszystkie wymiary są zestaw w milimetrach.Pomiar konwersja nastąpi w czasie wykonywania, jeśli Kultura and UICulture są zestaw do ustawień regionalnych, które nie korzystają z wartości metryki.
Aby zrozumieć wartości, które są używane wymiary strona i marginesów, można użyć GetProperties metoda do pobierania wartości domyślnych:
PageHeight and PageWidth Określ szerokość i wysokość strona domyślnej.Podczas drukowania formantu jest uruchamiany, wartości te właściwość służą do wybierania najbliższego rozmiaru papieru dostępne dla aktualnie wybranej drukarki.Jeśli PageWidth jest bardzo niż PageHeight, orientację jest zestaw pozioma.W przeciwnym razie jest zestaw do pionowo.
LeftMargin, RightMargin, TopMargin, and BottomMargin są wszystkie domyślnie ustawione na 12.2 milimetry.
Te właściwości są przechowywane w Element Kolekcja właściwości serwer raportów. Wartości są zastępowane każdego czas aktualizacji definicja raportu.
Właściwości RSPrintClient
Właściwość |
Typ |
RW |
Default |
Description |
|---|---|---|---|---|
MarginLeft |
Double |
RW |
Ustawienia raportu |
Pobiera lub ustawia lewy margines.Wartością domyślną, jeśli nie zestaw przez projektanta lub określony w raporcie jest 12.2 milimetry. |
MarginRight |
Double |
RW |
Ustawienia raportu |
Pobiera lub ustawia prawy margines.Wartością domyślną, jeśli nie zestaw przez projektanta lub określony w raporcie jest 12.2 milimetry. |
MarginTop |
Double |
RW |
Ustawienia raportu |
Pobiera lub ustawia margines górny.Wartością domyślną, jeśli nie zestaw przez projektanta lub określony w raporcie jest 12.2 milimetry. |
MarginBottom |
Double |
RW |
Ustawienia raportu |
Pobiera lub ustawia margines dolny.Wartością domyślną, jeśli nie zestaw przez projektanta lub określony w raporcie jest 12.2 milimetry. |
PageWidth |
Double |
RW |
Ustawienia raportu |
Pobiera lub Ustawia szerokość strona.Wartością domyślną, jeśli nie zestaw przez projektanta lub raportu definicja jest 215.9 milimetry. |
PageHeight |
Double |
RW |
Ustawienia raportu |
Pobiera lub Ustawia wysokość strona.Wartością domyślną, jeśli nie zestaw przez projektanta lub raportu definicja jest 279,4 milimetry. |
Kultura |
Int32 |
RW |
regionalny przeglądarki |
Określa identyfikator regionalny (LCID).Ta wartość określa jednostki miary dla danych wprowadzanych przez użytkownika.Na przykład, jeśli użytkownik wpisze 3, wartość będzie mierzone w milimetrach, jeśli w języku francuskim lub inches Jeśli językiem jest angielski (Stany Zjednoczone).Prawidłowe wartości to: 1028, 1031, 1033, 1036, 1040, 1041, 1042, 2052, 3082. |
UICulture |
String |
RW |
Kultury klient |
Określa ciąg lokalizacja w oknie dialogowym.Tekst w oknie dialogowym Drukowanie jest zlokalizowany w tych językach: Chiński uproszczony, chiński tradycyjny, angielski, francuski, niemiecki, włoski, japoński, koreański i hiszpański. Prawidłowe wartości to: 1028, 1031, 1033, 1036, 1040, 1041, 1042, 2052, 3082. |
Uwierzytelnianie |
Boolean |
RW |
Fałsz |
Określa, czy formant wyda polecenie GET przed serwer raportów do nawiązywania połączeń wychodzących sesja drukowania. |
Kiedy zestaw uwierzytelnienia właściwość
Podczas drukowania z sesja przeglądarki, nie trzeba zestaw Authenticate Właściwość. W kontekście aktywnej sesja wszystkie żądania z formantu wydruku serwer raportów są obsługiwane za pomocą przeglądarki.Przeglądarka ustawia zmienne sesyjne niezbędne do komunikacji serwer raportów.
Jeśli drukujesz się z sesja (na przykład wysyłanie raportu bezpośrednio do drukarki bez otwierania pierwszego), wydruku formantu musi wystawić HTTP GET żądanie zestaw up sesja z serwer raportów. Problem GET żądanie, który zestaw Authenticate Aby True.
Trzeba wydać GET żądania, jeśli używasz zintegrowanych zabezpieczeń systemu Windows lub uwierzytelnianie podstawowego. Jeśli korzystasz z uwierzytelnianie formularzy Authenticate Właściwość jest ignorowana. Kod aplikacji musi zestaw sesja i uwierzytelniania użytkownika przy użyciu rozszerzenia niestandardowe zabezpieczeń, które podasz.Jeśli korzystasz z uwierzytelnianie formularzy, upewnij się, że zestaw wartość wygaśnięcia na wartość, która zachowuje sesji dla odpowiedni odstęp czasowy plik cookie uwierzytelnianie.Jeśli wartość jest zbyt niska, użytkownicy byli monitowani o podanie poświadczenia logowania przy każdym plik cookie traci ważność.
Metoda RSPrintClient wydruku
The RSClientPrint object supports the Print metoda used to launch the Print dialog box.The Print metoda has the following arguments.
Argument |
WE/WY |
Typ |
Description |
|---|---|---|---|
ServerPath |
In |
String |
Określa serwer raportów katalog wirtualny (na przykład https://adventure-works/reportserver). |
ReportPathParameters |
In |
String |
Określa pełną nazwę raportu w przestrzeni nazw folderu serwera raportów, włącznie z parametrami.Raporty są pobierane poprzez dostęp URL.Na przykład „/AdventureWorks Sample Reports/Employee Sales Summary&EmpID=1234” |
ReportName |
In |
String |
Krótka nazwa raportu (w powyższym przykładzie krótka nazwa jest podsumowanie sprzedaży pracownik).Jest wyświetlany w oknie dialogowym Drukuj i w kolejce wydruku. |
Przykład
W poniższym przykładzie HTML pokazano sposób określania pliku .cab Drukowanie metoda i właściwości w JavaScript:
<BODY onload="Print()">
<OBJECT ID="RSClientPrint" CLASSID="CLSID:FA91DF8D-53AB-455D-AB20-F2F023E498D3" CODEBASE="<URL to the .CAB file>#Version=<your application version information>" VIEWASTEXT></OBJECT>
<script language="javascript">
function Print()
{
RSClientPrint.MarginLeft = 12.7;
RSClientPrint.MarginTop = 12.7;
RSClientPrint.MarginRight = 12.7;
RSClientPrint.MarginBottom = 12.7;
RSClientPrint.Culture = 1033;
RSClientPrint.UICulture = 9;
RSClientPrint.Print('https://localhost/rtm', '%2fEmployee_Sales_Summary&ReportMonth=6&ReportYear=2004&EmpID=20', 'Employee_Sales_Summary')
}
</script>
</BODY>
See Also